zhangfucai dfb341e7ed 更新 .claude/skills/iter/SKILL.md

2026-01-26 15:58:54 +08:00

5.1 KiB

Raw Blame History

name	description
iter	迭代变更入口，调研问题后更新 PRD.md 和 tasks.md，支持 Bug 修复、功能迭代、技术重构。

Iterate - 迭代变更

定位：1-100 阶段的变更入口。项目已上线，需要修复问题或迭代功能时，通过此 skill 调研、澄清、更新文档。

当用户调用 /iter 或 /iter <问题描述> 时，执行以下步骤： ⚠️ 重要：本 skill 只修改文档（PRD.md、tasks.md），绝不执行代码、不运行命令、不修改源文件。

1. 获取变更描述

如果用户提供了参数，使用该描述。否则询问：

请描述需要迭代的内容（Bug/功能/重构）

示例输入：

"登录验证存在漏洞，token 过期后仍可访问"
"列表页需要增加按时间筛选功能"
"用户模块性能太差，需要重构缓存策略"

2. 调研分析

2.1 读取现有文档

读取以下文件了解当前状态：

doc/PRD.md - 了解产品定义
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

使用增量修改标记：

<!-- ITER: {日期} - {变更简述} -->
<!-- NEW START -->
新增内容...
<!-- NEW END -->

或修改现有内容：

<!-- ITER: {日期} - {变更简述} -->
<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容

更新位置：

Bug 修复 → 更新对应功能的验收标准
功能迭代 → 在 3.2 功能详情添加/修改功能点
技术重构 → 在 4.x 非功能需求或 7.1 技术约束中说明

4.2 更新 tasks.md

新增任务使用标记：

<!-- ITER: {日期} - {变更简述} -->
| T-xxx | {任务名} | {描述} | {依赖} | {优先级} | {验收标准} |

任务 ID 规则：

查找现有最大 ID，递增分配
格式：T-xxx（三位数字）

4.3 标记规范

所有变更使用  前缀，区分于 /mp /mt 的标记：


便于追溯迭代历史

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` 等

5.1 KiB Raw Blame History Unescape Escape