SuperAPI AI 工具集

project-specification

办公与效率

查看项目

更新于 10-15 17:20

技能介绍

用途:把项目简报转为可测试的规格,产出用户故事与验收标准;适用时机为头脑风暴完成之后、需要为实施准备可测试验收标准、把业务需求翻译为技术规格、定义范围与排除项时。不适合仍在探索问题(改用项目头脑风暴)、已有详细规格(改用项目规划)或做战略决策的场景。

主要能力:当环境中有 spec-kit 时,方法论委托给 Skill(spec-kit:spec-writing),复用其模板与校验,并支持澄清(clarification)流程;没有 spec-kit 时使用独立的规格框架、需求模板与验收标准模式。需把简报中的文档受众字段带入规格并作为需求对待,未设定时应主动询问而非猜测;同时指定深挖文档归属位置(技能用 modules/,仓库文档用 docs/deep-dive/<topic>.md)。若规格确定了存在真实备选方案的设计决策,应记录到 docs/tradeoffs.md:装有 leyline 时调用 Skill(leyline:decision-journal) 追加条目(含决策、权衡选项与被牺牲项,phase 设为 specify),先展示草稿再确认追加;无 leyline 时按文件内 ENTRY TEMPLATE 追加并分配下一个 TR-NNN 编号。

使用方式:通过命令 /attune:specify 触发,澄清流程用 /attune:specify --clarify;后续步骤为 /attune:blueprint。质量检查通过且 docs/specification.md 保存后须自动调用 Skill(attune:project-planning),显示“Specification complete. Saved to docs/specification.md. Proceeding to planning phase...”。仅在提供 --standalone、规格文件不存在或为空、或用户明确要求停止时跳过续接,无需向用户请求确认。

限制与退出标准:docs/specification.md 须存在、非空并通过质量检查;每条功能需求都要有可测试验收标准;文档受众层级需写明;有意义的设计分叉须记录到 docs/tradeoffs.md;除绕过条件外自动进入下一阶段。相关技能含 spec-kit:spec-writing、attune:project-brainstorming、attune:project-planning、attune:mission-orchestrator。完整示例见 /attune:specify 命令文档。价格、平台等信息暂未提供。