SuperAPI AI 工具集

indexion-sdd

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:把 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) 传入。其余安装细节与版本要求资料未完整提供。