SuperAPI AI 工具集

spec-creator

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:把用户想法转成实现级 SPEC.md。目标质量是“可移植实现契约”——任何语言下的合格工程师或 AI 代理都能据此构建一致实现,文档自包含,代理只读该文件即可实现系统。

主要流程分 4 阶段。阶段 1 需求接收与校准:从用户输入中提取决策、约束、技术选型、边界、实体与观点,按信息深度分类为稀疏、中等、丰富,并先复述理解以便用户纠正。阶段 2 头脑风暴:按轮提问,每轮 3-6 个按主题分组的问题,不一次性抛出;持续到 10 个知识域覆盖充分,包括问题与范围、架构与组件、领域模型、配置与输入、状态与生命周期、集成契约、失败与恢复、安全与安全、可观测性、测试与验证;按输入深度调整轮数与起点。阶段 3 起草 SPEC.md:按参考章节模板撰写,章节涵盖问题陈述、目标与非目标、系统概览、核心领域模型、领域特定契约、配置规范、状态机、核心算法、集成契约、子系统契约、提示/上下文组装、日志与可观测性、失败模型与恢复、安全与运行安全、参考算法、测试与验证矩阵、实现检查清单。起草要求每个字段有类型、每个默认值有具体数值、每个错误有名称与恢复行为、每个边界同时说明在范围内与不在范围内,复杂逻辑用语言无关伪代码,并附配置速查表与测试矩阵;默认输出单个 SPEC.md,超过约 2000 行可拆分为 SPEC.md、DOMAIN_MODEL.md、TEST_MATRIX.md。阶段 4 自审:逐节检查代理能否无追问实现,修正模糊默认值、缺失错误处理、隐式状态转换、无上限行为、不清边界、缺失类型与含糊章节,并给出审查摘要、剩余 [TBD] 与置信评估。

适用场景:需要为 AI 编码代理准备实现契约、架构与接口规格时使用。限制:不写用户故事与验收标准的 PRD 内容,不停留在框线图,不写备选方案与决策理由(除非用户明确要 ADR),不讲解通用概念,不在用户未明确选择时规定语言、框架或库。本文未提供安装命令、价格或运行平台信息。