cs-issue-analyze 是 CodeStable 工作流中的一个阶段技能,用途是在问题报告已确认后做根因分析:读代码找根因、评估风险、给出修复方案,但自身不改代码。触发场景是已有 report 后需要找根因、评估风险、给修复方案。
启动前需先执行 CodeStable preflight:读 .codestable/attention.md,缺失则先 cs-onboard;共享路径与命名约定见 .codestable/reference/shared-conventions.md 第 0 节和 cs-issue 的“文件放哪儿”。启动检查要求读 {slug}-report.md,确认 doc_type=issue-report 且 status=confirmed、5 节都有内容;不完整或状态不对则回到 cs-issue-report。若 {slug}-analysis.md 已存在,则按已填节数做断点恢复。
分析分五步:定位问题代码(用 Grep/Glob 找函数、类、文件名,沿调用链追溯,记录 {文件}:{行号});还原失败路径(对照复现步骤走执行路径,找出正常与失败路径的分叉点);确认根因(区分单一或多个根因,归类为逻辑错误、状态污染、数据格式、并发/竞态、配置/环境、缺少防御);影响面评估(影响范围、潜在受害模块、数据完整性风险、严重程度复核);修复方案选项(列 2-3 种方向,说明做什么、优点、缺点风险、影响面,并给出推荐)。分析需按模板写入 issue-analysis 文档,含问题定位、失败路径还原、根因、影响面、修复方案五节。
完成后需与用户对齐:口头总结根因和推荐方案,确认判断是否准确、方案是否认可,用户明确确认方案后才进入阶段 3(触发 cs-issue-fix)。明确限制:不能只靠推断或报告猜测而不读代码;不能只列一种修复方案;不能在用户确认前直接改代码;根因须定位到 file:line;影响面须具体;严重程度复核要据影响面判断而非总维持。其他细节资料未提供。