SuperAPI AI 工具集

spec-readiness

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:Spec Readiness 是一个规格就绪度审查技能,用于判断某份具名实现规格能否直接交给实现者,而不迫使实现者自行发明结构性契约。它从实现者视角提问:若明天开始实现,哪些契约本应由规格决定却仍待选择。

主要能力:按契约台账检查每个独立工作包与生产者-消费者/授权交接边,覆盖所有者与结果、输入与授权、公共契约与身份、结果、状态与效果、证明等行。仅当不同选择会改变已声明的工作包、消费者或可观察契约时,才判定为 Blocker。支持收敛法则、冻结边界、反向路径与验收路径检查,并区分实现自由与阻塞项。

使用方式:默认使用 full 模式;重审模式选择、收敛与增量流程参考 references/incremental-review.md。若调用包含 Adapter: codex-task-to-spec,需校验具名 packet manifest 与哈希,完整读取冻结锁与种子清单,并只审查所提供的分离提交。若该适配器调用含 Stage: resolution-check,则暂停常规裁决格式,只返回 Resolved、Lock、Resume、Basis 四行。若调用含 Write report under:,则在该目录写入 YYYY-MM-DD-HHMM-spec-readiness.md,重名时追加 -2、-3 等;否则仅聊天输出,不创建或修改文件。若含 Lock:,需完整读取该文件作为冻结锁。

适用场景:在规格进入实现或评审阶段前做就绪度门禁,尤其适合多组件、公共类型/身份、持久或并发状态边界等结构性场景。

限制:不编辑规格或代码;不猜测写入路径;不进行开放式仓库扫描;无当前可识别规格时返回 NOT READY 并停止;不把重复根因、历史评审失败或评审模式本身当作 Blocker;不规定架构,除非多种契约都能满足结果。具体命令、安装方式与收费信息暂未提供。