cs-issue 的用途是给修 bug 流程做路由。它不做具体判断或修改,只查看已有 issue 文件、判断当前走到哪一步,再决定触发哪个子技能。启动前需先执行 CodeStable preflight:读 .codestable/attention.md;缺失则先 cs-onboard;不得用外部 AI 入口替代。
流程分标准路径与快速通道。标准路径:阶段1 问题报告由 cs-issue-report 产出 {slug}-report.md;阶段2 根因分析由 cs-issue-analyze 产出 {slug}-analysis.md;阶段3 修复验证由 cs-issue-fix 产出代码、{slug}-fix-note.md 与 scoped-commit。阶段间设人工 checkpoint。快速通道条件:AI 读代码后对根因高度有把握并能指出 file:line 与原因、改动仅 1-2 处、无跨模块风险;此时直接告知根因与方案,用户确认后修复并验证,再写 fix-note.md,省去 report 与 analysis。是否进快速通道由 cs-issue-report 启动检查做唯一判定,进入标准路径后不再二次改判。根因有多个候选、涉及多模块、需先复现或需完整存档时不走快速通道。
路由规则:先 Glob .codestable/issues/ 并读已有文件。无任何文件时触发 cs-issue-report;已有 report.md 无 analysis.md 触发 cs-issue-analyze;已有 analysis.md 且代码未改、或代码已改但无修复验证记录时触发 cs-issue-fix;不确定则自行读文件按表判断。若用户描述的是新功能需求而非 bug,应改走 cs-feat。
产物存放于 .codestable/issues/{YYYY-MM-DD}-{slug}/,包含 {slug}-report.md、{slug}-analysis.md、{slug}-fix-note.md;fix-note.md 为阶段3 必出产物。文档带 YAML frontmatter(doc_type 为 issue-report / issue-analysis / issue-fix),便于 search-yaml.py 按 severity / tags / status 检索。