SuperAPI AI 工具集

cs-issue-fix

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:本技能属于 CodeStable 工作流,处理已确定根因与方案的 Issue 修复,负责按方案改代码、验证效果、写修复记录。开始前需执行 preflight:读 .codestable/attention.md,缺失先 cs-onboard。

主要能力与入口:分标准路径(读 analysis,确认 doc_type=issue-analysis、status=confirmed 并选定方案)与快速通道(无 analysis,从 report 直接触发,需先陈述根因并让用户确认方案)。两入口均需读 attention.md,并用 grep -r "{关键词}" .codestable/compound/ 检索沉淀目录。

执行 gate:修复前运行 start gate,完成汇报前运行 commit gate,命令分别为 python3 .codestable/tools/codestable-worktree-gate.py --root . --json start --unit .codestable/issues/YYYY-MM-DD-{slug} 与同工具的 commit 子命令;gate 不通过不开始改代码或不提交。

约束:只改 analysis 声明的文件;改动最小化,不引入新抽象、接口或模式;范围外发现记为“顺手发现”另开 issue;每完成一处改动按模板汇报并等用户回复。验证清单含复现步骤、期望行为、影响面回归、前端浏览器验证、相关测试。未生效时切换到日志调试,不在原假设上反复试错。

产出与收尾:验证通过后建 {slug}-fix-note.md,按 scoped-commit 规则提交,收尾推荐进入 cs-code-review 做独立 diff 评审,并可沉淀 compound 或记入 attention.md。易踩坑包括未走验证清单即宣告修好、改范围外代码、未建 fix-note、只 typecheck 前端、日志未清理即提交、未经用户同意 commit。

限制:具体模板、工具安装与 hook 说明、命名约定等位于 .codestable 下引用文件,本介绍暂未提供其完整内容。