用途:cs-audit 补上“不知道哪有问题,先扫一遍”的诉求,在用户限定范围内主动扫描代码,产出按严重度 × 性质交叉分类的发现清单。它只发现、不定修,修复交给 cs-issue 或 cs-refactor。
启动前需执行 CodeStable preflight:读 .codestable/attention.md;缺失先 cs-onboard;不读外部 AI 入口替代。
主要能力:每个发现打两个标签——性质(bug、security、performance、maintainability、arch-drift)与严重度(P0 必须修、P1 应该修、P2 可以修),并带置信度(high/medium/low)和建议动作。扫描维度包括 bug 隐患、安全、性能、可维护性、架构偏离;架构偏离须对照 .codestable/requirements/adrs/,不得凭记忆判断。
使用方式:工作流分四阶段。Phase 1 范围收敛,用户需提供关键词、模块/目录或一段话描述之一;用户说“整个项目都扫”会被推回,建议先扫最常改或最近出问题的区域,收敛后与用户确认。Phase 2 按圈定维度扫描,用 Glob/Grep/Read 真实读代码,每条发现记录文件:行号与具体代码片段,每种维度最多报 5 条。Phase 3 定级并产出,先写 index.md 再逐条写 finding-NN.md,文件放在 .codestable/audits/{YYYY-MM-DD}-{slug}/,带 YAML frontmatter 便于检索。Phase 4 在 index.md 末尾给按优先级排列的下一步建议,用户选择后路由到 cs-issue 或 cs-refactor。
适用场景:审查系统、扫描 bug/安全/性能/架构债,产出发现清单。
限制:不盲扫全仓库,无范围不动手;每条发现必须有证据,不准出现无证据发现;置信度必标,不准全标 high;每种维度上限 5 条;只发现不定修,出现“顺便修了”即越界;旧审计被新审计覆盖时,旧 index 标 status: superseded 与 superseded-by。若零发现,告知用户此范围内未发现明显问题。相关文档包括 reference.md、.codestable/reference/shared-conventions.md 与 .codestable/requirements/adrs/。