name	fix
description	读最新 design + 相关 feat/task/execute → brainstorming → 直接生成修复 Tasks（不生成 fix 设计文档）

Fix — 修复任务清单生成

本 Skill 负责：

承接 discover 已确认的 FIX 类需求
生成修复任务清单（Tasks），用于 Bug 修复/回归修复/小范围稳定性改进
不生成 fix 设计文档
保证与 Design/已有 Feature 的约束一致
通过 execute 历史记录做冲突与重复修复检查

本 Skill 仅可在 `discover` 已输出 `NEXT_STATE: FIX` 后触发。

执行过程中：

禁止重新进行需求分流
禁止重复执行 discover 职责
禁止生成实现代码
禁止生成 patch / diff / PR / git 命令
禁止描述函数级或行级修改步骤
禁止生成除 docs/tasks/*.md 外的任何文件
禁止运行会改变工作区的命令

允许读取： - `docs/*-design.md` # 最新全局设计基线 - `docs/features/*.md` # 既有功能规格，只读 - `docs/tasks/*.md` # 既有任务文档，只读 - `docs/executes/*.md` # 既有执行记录，只读 - `templates/tasks.md` # 插件 Tasks 模板

允许写入：

docs/tasks/*.md

输入前提（Preconditions）

触发本 Skill 前，必须满足：

已完成 discover
discover 输出结果为：

NEXT_STATE: FIX

流程（Process）

1) 读取最新 Design

查找 docs/*-design.md
以文件名时间戳排序取最新
提取与本修复相关的：Constraints、Key Decisions、Project-level AC、Risks

2) 读取相关 Feature / Tasks（如有）

相关性匹配规则（满足任一即相关）：
1. 文件名包含同一个 <fix-name> 或相关关键词/模块名
2. 文档内 关联条目（Refs） 包含相同的 [D?]/[AC?] 或同一模块/接口
3. References 引用同一 Design 版本
用途：
- 确认是否已有任务在修同一问题（避免重复修复）
- 找到既有验收点/回归点（FR/AC/TC）

3) 读取相关 Execute（冲突检查，必做）

相关性匹配规则（满足任一即相关）：
1. execute 的 关联条目（Refs） 命中相同模块/接口/关键词
2. execute 的 Files Changed 涉及同一目录/文件
3. execute 的 FAIL/回滚/Notes 指向同一现象或回归点
冲突/风险判定（出现任一必须在 Tasks 风险中写明）：
- 已有 PASS 的 execute 已覆盖同一修复点（疑似重复）
- 最近存在 FAIL/回滚，且触达同一模块（高回归风险）
- execute 记录的接口契约/行为与本次修复预期不一致

4) Brainstorming（强制收敛）

调用 /brainstorming 进行需求分析
必须产出以下"修复闭环"要素：
- 复现步骤（Repro）：最小复现输入/环境
- 根因假设（Root Cause Hypothesis）：可能原因与排查路径
- 修复策略（Fix Strategy）：最小变更原则
- 回归面（Regression Surface）：可能受影响的旧行为
- 验收点（Acceptance）：复现失败→修复后通过→回归测试通过

5) 直接生成 Tasks（Template Fill）

只能使用 templates/tasks.md
Tasks 的 References 必须包含（最少）：
- Design: <latest design filename>
- Related Feat: ...（如存在）
- Related Execute: ...（如存在，尤其是 FAIL/回滚相关）
Tasks 拆分强制规则（修复闭环）：
- Task 1：复现与定位（增加最小复现/测试/日志，Acceptance 证明能稳定复现）
- Task 2：修复实现（最小变更，Acceptance 证明修复生效）
- Task 3：回归与加固（补测试/检查点，Acceptance 证明无回归）
- 若问题极小可合并 Task，但必须在同一 Task 内包含"复现→修复→回归"的验收链条

输出（Output）

生成：docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md

命名规则：

<fix-name> 规则：小写英文/数字/短横线（kebab-case），例如 panic-on-empty-input

失败处理（Failure Modes）

找不到 templates/tasks.md：停止并报告错误（不得生成 tasks）
找不到 design：停止并报告错误（不得生成 tasks）
无法确定复现/验收：允许在 Task 中标注 TBD，但必须将首个 Task 设为"补齐复现与验收"

Fix 边界（Definition of Fix）

允许（Allowed Fix）：

修复 bug、空指针/崩溃、逻辑错误、兼容性问题、性能回退、可靠性缺陷
增补测试、加日志/观测点（仅限定位与验证）
小范围重构（仅为修复所必需，且需在 Task Scope 明确列出）

禁止（Not a Fix / Out of scope）：

新增功能、扩展需求范围（应走 feat）
大规模重构、架构调整（应走 feat/design）
变更公共接口契约（除非是向后兼容修复，并在 Task 中写清迁移/回滚）

手动执行（Manual Execution）

本次 fix 只生成任务清单，不会执行任何代码变更。

1) 选择要执行的 Task

打开本次生成的 Tasks 文件：

docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md

从中挑选一个 Task ID（建议从 1 开始，按顺序推进）。

2) 调用 Execute 技能执行该 Task

在 ClaudeCode 中运行：

/execute docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md:<task-id>

name	fix
description	读最新 design + 相关 feat/task/execute → brainstorming → 直接生成修复 Tasks（不生成 fix 设计文档）

Fix — 修复任务清单生成

本 Skill 负责：

承接 discover 已确认的 FIX 类需求
生成修复任务清单（Tasks），用于 Bug 修复/回归修复/小范围稳定性改进
不生成 fix 设计文档
保证与 Design/已有 Feature 的约束一致
通过 execute 历史记录做冲突与重复修复检查

本 Skill 仅可在 `discover` 已输出 `NEXT_STATE: FIX` 后触发。

执行过程中：

禁止重新进行需求分流
禁止重复执行 discover 职责
禁止生成实现代码
禁止生成 patch / diff / PR / git 命令
禁止描述函数级或行级修改步骤
禁止生成除 docs/tasks/*.md 外的任何文件
禁止运行会改变工作区的命令

允许写入：

docs/tasks/*.md

输入前提（Preconditions）

触发本 Skill 前，必须满足：

已完成 discover
discover 输出结果为：

NEXT_STATE: FIX

流程（Process）

1) 读取最新 Design

查找 docs/*-design.md
以文件名时间戳排序取最新
提取与本修复相关的：Constraints、Key Decisions、Project-level AC、Risks

2) 读取相关 Feature / Tasks（如有）

相关性匹配规则（满足任一即相关）：
1. 文件名包含同一个 <fix-name> 或相关关键词/模块名
2. 文档内 关联条目（Refs） 包含相同的 [D?]/[AC?] 或同一模块/接口
3. References 引用同一 Design 版本
用途：
- 确认是否已有任务在修同一问题（避免重复修复）
- 找到既有验收点/回归点（FR/AC/TC）

3) 读取相关 Execute（冲突检查，必做）

相关性匹配规则（满足任一即相关）：
1. execute 的 关联条目（Refs） 命中相同模块/接口/关键词
2. execute 的 Files Changed 涉及同一目录/文件
3. execute 的 FAIL/回滚/Notes 指向同一现象或回归点
冲突/风险判定（出现任一必须在 Tasks 风险中写明）：
- 已有 PASS 的 execute 已覆盖同一修复点（疑似重复）
- 最近存在 FAIL/回滚，且触达同一模块（高回归风险）
- execute 记录的接口契约/行为与本次修复预期不一致

4) Brainstorming（强制收敛）

调用 /brainstorming 进行需求分析
必须产出以下"修复闭环"要素：
- 复现步骤（Repro）：最小复现输入/环境
- 根因假设（Root Cause Hypothesis）：可能原因与排查路径
- 修复策略（Fix Strategy）：最小变更原则
- 回归面（Regression Surface）：可能受影响的旧行为
- 验收点（Acceptance）：复现失败→修复后通过→回归测试通过

5) 直接生成 Tasks（Template Fill）

只能使用 templates/tasks.md
Tasks 的 References 必须包含（最少）：
- Design: <latest design filename>
- Related Feat: ...（如存在）
- Related Execute: ...（如存在，尤其是 FAIL/回滚相关）
Tasks 拆分强制规则（修复闭环）：
- Task 1：复现与定位（增加最小复现/测试/日志，Acceptance 证明能稳定复现）
- Task 2：修复实现（最小变更，Acceptance 证明修复生效）
- Task 3：回归与加固（补测试/检查点，Acceptance 证明无回归）
- 若问题极小可合并 Task，但必须在同一 Task 内包含"复现→修复→回归"的验收链条

输出（Output）

生成：docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md

命名规则：

<fix-name> 规则：小写英文/数字/短横线（kebab-case），例如 panic-on-empty-input

失败处理（Failure Modes）

找不到 templates/tasks.md：停止并报告错误（不得生成 tasks）
找不到 design：停止并报告错误（不得生成 tasks）
无法确定复现/验收：允许在 Task 中标注 TBD，但必须将首个 Task 设为"补齐复现与验收"

Fix 边界（Definition of Fix）

允许（Allowed Fix）：

修复 bug、空指针/崩溃、逻辑错误、兼容性问题、性能回退、可靠性缺陷
增补测试、加日志/观测点（仅限定位与验证）
小范围重构（仅为修复所必需，且需在 Task Scope 明确列出）

禁止（Not a Fix / Out of scope）：

新增功能、扩展需求范围（应走 feat）
大规模重构、架构调整（应走 feat/design）
变更公共接口契约（除非是向后兼容修复，并在 Task 中写清迁移/回滚）

手动执行（Manual Execution）

本次 fix 只生成任务清单，不会执行任何代码变更。

1) 选择要执行的 Task

打开本次生成的 Tasks 文件：

docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md

从中挑选一个 Task ID（建议从 1 开始，按顺序推进）。

2) 调用 Execute 技能执行该 Task

在 ClaudeCode 中运行：

/execute docs/tasks/YYYY-MM-DD-HH-MM-<fix-name>.md:<task-id>

fix

Fix — 修复任务清单生成

输入前提（Preconditions）

流程（Process）

1) 读取最新 Design

2) 读取相关 Feature / Tasks（如有）

3) 读取相关 Execute（冲突检查，必做）

4) Brainstorming（强制收敛）

5) 直接生成 Tasks（Template Fill）

输出（Output）

失败处理（Failure Modes）

Fix 边界（Definition of Fix）

手动执行（Manual Execution）

1) 选择要执行的 Task

2) 调用 Execute 技能执行该 Task

المزيد من هذا المستودع

المزيد من هذا المستودع

Fix — 修复任务清单生成

输入前提（Preconditions）

流程（Process）

1) 读取最新 Design

2) 读取相关 Feature / Tasks（如有）

3) 读取相关 Execute（冲突检查，必做）

4) Brainstorming（强制收敛）

5) 直接生成 Tasks（Template Fill）

输出（Output）

失败处理（Failure Modes）

Fix 边界（Definition of Fix）

手动执行（Manual Execution）

1) 选择要执行的 Task

2) 调用 Execute 技能执行该 Task