用途:把 RFC、ISO 标准或 Markdown 规范转成 SDD 需求草案,并在编码过程中持续验证实现是否符合规范。适合希望按规范实现库或包、需要验证规范与实现一致性、或在合并前检查漂移的场景。
主要能力:
- spec draft 把规范文档转为需求,输出采用 ### Requirement N: 与 #### N.M: 层级。
- spec align diff/status 做规范与实现的漂移检测,可识别 DRIFTED、SPEC_ONLY、SHALLOW(仅类型定义无实质函数)等状态。
- spec verify 生成验证报告;再结合 agent 驱动的定性复核形成验证闭环。
必要用法:先安装 cc-sdd 并设置 --lang 与代码语言一致(代码为英文用 --lang en),否则 spec align diff 的词汇匹配会失效。项目初始化并 git init 后,用 indexion spec draft --output .kiro/specs/<feature>/requirements.md rfc_document.md 生成草案;需求写完后与源规范做对齐检查。各任务提交后运行漂移门禁,如 indexion spec align status ... --fail-on drifted(Phase A,容 SHALLOW)或 --fail-on any(Phase B,Shallow 必须为 0)。SHALLOW 需在同一文件内补充超过 4 行的非平凡函数。
限制:spec align 只做词汇重叠检查,无法识别用词相同但意图相反的隐藏缺口,需人工复核;SHALLOW 按文件判定,逻辑写在别的文件不会消除。非交互执行可用 codex exec --full-auto --json 并配合 tail -f 监控,长提示建议写入文件后用 $(cat file.md) 传入。其余安装细节与版本要求资料未完整提供。