ac0f086821
- 完成 T-001A: 前端项目初始化 (Next.js 14 + TypeScript + Tailwind CSS) - 完成 T-001B: 后端项目初始化 (FastAPI + SQLAlchemy + asyncpg) - 完成 T-002: 数据库配置 (KolVideo 模型 + 索引 + 测试) - 完成 T-003: 基础 UI 框架 (Header/Footer 组件 + 品牌色系) - 完成 T-004: 环境变量配置 (前后端环境变量) Co-Authored-By: Claude <noreply@anthropic.com>
211 lines
5.1 KiB
Markdown
211 lines
5.1 KiB
Markdown
---
|
||
name: iter
|
||
description: 迭代变更入口，调研问题后更新 PRD.md 和 tasks.md，支持 Bug 修复、功能迭代、技术重构。
|
||
---
|
||
|
||
# Iterate - 迭代变更
|
||
|
||
> **定位**：1-100 阶段的变更入口。项目已上线，需要修复问题或迭代功能时，通过此 skill 调研、澄清、更新文档。
|
||
|
||
当用户调用 `/iter` 或 `/iter <问题描述>` 时，执行以下步骤：
|
||
⚠️ 重要：本 skill 只修改文档（PRD.md、tasks.md），绝不执行代码、不运行命令、不修改源文件。
|
||
|
||
## 1. 获取变更描述
|
||
|
||
如果用户提供了参数，使用该描述。否则询问：
|
||
> 请描述需要迭代的内容（Bug/功能/重构）
|
||
|
||
**示例输入**：
|
||
- "登录验证存在漏洞，token 过期后仍可访问"
|
||
- "列表页需要增加按时间筛选功能"
|
||
- "用户模块性能太差，需要重构缓存策略"
|
||
|
||
## 2. 调研分析
|
||
|
||
### 2.1 读取现有文档
|
||
|
||
读取以下文件了解当前状态：
|
||
|
||
1. `doc/PRD.md` - 了解产品定义
|
||
2. `doc/tasks.md` - 了解任务现状
|
||
|
||
### 2.2 调研相关代码（可选）
|
||
|
||
根据问题描述，定位相关代码文件：
|
||
|
||
- 搜索关键词定位文件
|
||
- 读取相关模块代码
|
||
- 分析现有实现
|
||
|
||
### 2.3 分析变更类型
|
||
|
||
| 类型 | 特征 | 影响范围 |
|
||
|------|------|----------|
|
||
| Bug/漏洞 | 现有功能不符合预期 | 修复逻辑，可能涉及安全 |
|
||
| 功能迭代 | 在现有功能上增加/调整 | 新增或修改功能点 |
|
||
| 技术重构 | 不改功能，优化实现 | 性能、架构、代码质量 |
|
||
|
||
## 3. 澄清确认
|
||
|
||
**【必须】向用户提出澄清问题**，确保理解准确：
|
||
|
||
### 3.1 问题理解确认
|
||
|
||
向用户确认：
|
||
> 我理解的变更需求是：{一句话总结}
|
||
>
|
||
> 变更类型：{Bug修复 / 功能迭代 / 技术重构}
|
||
>
|
||
> 影响范围：{涉及的模块/功能}
|
||
|
||
### 3.2 方案选择（如有多种）
|
||
|
||
如果有多种解决方案，列出选项让用户选择：
|
||
|
||
```
|
||
方案 A：{描述}
|
||
- 优点：...
|
||
- 缺点：...
|
||
|
||
方案 B：{描述}
|
||
- 优点：...
|
||
- 缺点：...
|
||
|
||
请选择方案，或说明其他想法。
|
||
```
|
||
|
||
### 3.3 边界确认
|
||
|
||
确认变更边界：
|
||
> 本次变更**包含**：
|
||
> - {范围1}
|
||
> - {范围2}
|
||
>
|
||
> 本次变更**不包含**：
|
||
> - {排除项}
|
||
>
|
||
> 是否确认？
|
||
|
||
## 4. 用户确认后执行
|
||
|
||
**只有用户明确确认后**，才执行以下更新：
|
||
|
||
### 4.1 更新 PRD.md
|
||
|
||
使用增量修改标记：
|
||
|
||
```markdown
|
||
<!-- ITER: {日期} - {变更简述} -->
|
||
<!-- NEW START -->
|
||
新增内容...
|
||
<!-- NEW END -->
|
||
```
|
||
|
||
或修改现有内容：
|
||
|
||
```markdown
|
||
<!-- ITER: {日期} - {变更简述} -->
|
||
<!-- MODIFIED: 原内容为 "xxx" -->
|
||
修改后的内容
|
||
```
|
||
|
||
**更新位置**：
|
||
- Bug 修复 → 更新对应功能的验收标准
|
||
- 功能迭代 → 在 3.2 功能详情添加/修改功能点
|
||
- 技术重构 → 在 4.x 非功能需求或 7.1 技术约束中说明
|
||
|
||
### 4.2 更新 tasks.md
|
||
|
||
新增任务使用标记：
|
||
|
||
```markdown
|
||
<!-- ITER: {日期} - {变更简述} -->
|
||
| T-xxx | {任务名} | {描述} | {依赖} | {优先级} | {验收标准} |
|
||
```
|
||
|
||
**任务 ID 规则**：
|
||
- 查找现有最大 ID，递增分配
|
||
- 格式：T-xxx（三位数字）
|
||
|
||
### 4.3 标记规范
|
||
|
||
所有变更使用 `<!-- ITER: -->` 前缀，区分于 `/mp` `/mt` 的标记：
|
||
|
||
- `<!-- ITER: 2026-01-23 - 修复登录验证漏洞 -->`
|
||
- 便于追溯迭代历史
|
||
|
||
## 5. 输出摘要
|
||
|
||
完成后向用户展示：
|
||
|
||
```
|
||
## 迭代变更完成
|
||
|
||
**变更类型**: {Bug修复 / 功能迭代 / 技术重构}
|
||
|
||
**变更摘要**: {一句话描述}
|
||
|
||
**已更新文档**:
|
||
- doc/PRD.md: {更新位置}
|
||
- doc/tasks.md: 新增任务 T-xxx
|
||
|
||
**新增任务**:
|
||
| ID | 任务 | 优先级 |
|
||
|----|------|--------|
|
||
| T-xxx | {任务名} | P0/P1/P2 |
|
||
|
||
**下一步**:
|
||
- 执行任务 T-xxx
|
||
- 或运行 `/rp` `/rt` 评审变更
|
||
```
|
||
|
||
---
|
||
|
||
## 工作流示意
|
||
|
||
```
|
||
用户描述问题
|
||
│
|
||
▼
|
||
┌─────────────┐
|
||
│ 调研分析 │ ──▶ 读取 PRD、tasks、相关代码
|
||
└──────┬──────┘
|
||
│
|
||
▼
|
||
┌─────────────┐
|
||
│ 澄清确认 │ ──▶ 提问 → 用户回答 → 确认方案
|
||
└──────┬──────┘
|
||
│
|
||
▼ 用户确认
|
||
┌─────────────┐
|
||
│ 更新文档 │ ──▶ PRD.md + tasks.md
|
||
└──────┬──────┘
|
||
│
|
||
▼
|
||
┌─────────────┐
|
||
│ 输出摘要 │
|
||
└─────────────┘
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- **必须先澄清确认**，不要假设用户意图
|
||
- 变更范围要明确，避免 scope creep
|
||
- 优先级根据问题严重程度判断：
|
||
- 安全漏洞 → P0
|
||
- 功能 Bug → P0/P1
|
||
- 功能迭代 → P1/P2
|
||
- 技术重构 → P1/P2
|
||
- 只更新 PRD + tasks，保持轻量
|
||
- 如需更新其他文档，提示用户手动运行 `/mf` `/md` 等
|
||
|
||
## 与其他 skill 的关系
|
||
|
||
| 场景 | 使用 skill |
|
||
|------|------------|
|
||
| 迭代变更入口 | `/iter`（本 skill） |
|
||
| 需要更新 FeatureSummary | `/iter` 后运行 `/mf` |
|
||
| 需要更新 DevelopmentPlan | `/iter` 后运行 `/md` |
|
||
| 需要评审变更 | `/iter` 后运行 `/rp` `/rt` |
|
||
| 从头生成文档 | 使用 `/wp` `/wf` `/wd` 等 |
|