SuperAPI AI 工具集

cy-spec-preflight

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:在 cy-create-prd、cy-create-techspec、cy-create-tasks 等技能产出草稿前,先加载项目记忆与活动上下文,并在草稿完成后运行对应检查,减少遗漏项目特定指令(如 PRD 中出现的框架名、纯文字 TechSpec、测试覆盖不足)的问题。

主要能力:按阶段(prd、techspec、tasks、task-body)执行检查。加载 docs/_memory/spec-authoring-playbook.md、standing_directives.md、glossary.md、按阶段对应的 lessons、CLAUDE.md 相关章节;解析活动任务 slug,读取已有 _techspec.md、adrs/.md、analysis/.md 及前一阶段产物。PRD 阶段运行 python3 scripts/check-prd-implementation-leak.py <prd_path> 检查实现细节泄漏;TechSpec 阶段运行 python3 scripts/check-techspec-markers.py <techspec_path> 验证六个标记,并检查测试计划、公共接口、扩展性、智能体可管理性、配置生命周期等章节;tasks 阶段检查表格列顺序、MVP 边界、依赖、复杂度、末尾 QA 对、Web/Docs Impact 等;task-body 阶段检查关键提示块、文件、测试与引用。

使用方式:作为前置技能,在内部 cy-create-* 技能编写草稿前完成 before authoring 检查,草稿产生后、用户批准或任务执行前完成 after draft 检查。phase 可省略,从活动技能或产物路径推断。

限制:playbook 缺失时须停止;phase 无法推断时须询问用户,不得猜测;脚本结构错误时只报告路径,不自动修复;TechSpec 缺少标记不得跳过;_tasks.md 缺少 QA 对或 Web/Docs Impact 时自动调用相应技能修复;缺少扩展性、可管理性或配置生命周期分析时阻止批准。PRD 不调用 cy-spec-peer-review,该评审仅限 TechSpec 且需用户明确选择。