SuperAPI AI 工具集

blueprint-creator

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:blueprint-creator 是技能流程中的一环,将 SPEC.md 这一实现契约膨胀为最细致粒度的 BLUEPRINT.md,目标是让 AI 编码代理可直接把内容机械翻译成代码,而无需任何解释性决策。流程位置标注为 SPEC.md → BLUEPRINT.md → Code。

前置条件:必须先存在 SPEC.md,这是硬性门槛。需按顺序在工作目录查找 SPEC.md、spec.md、SPEC_*.md 或 /mnt/user-data/uploads/,确认聊天中是否粘贴或附带规格内容,以及用户是否提到此前创建的规格。若未找到,必须停止并告知需要 SPEC.md,可建议先用 spec-creator 技能生成规格,不得在没有 SPEC.md 的情况下生成蓝图。

主要能力:相比 SPEC,蓝图在字段上补充精确校验规则、无效输入错误与所有使用点交叉引用;提供含全部字段的规范示例及边缘变体;为算法提供伪代码、决策表、时序图与边缘用例表;为错误提供代码、消息模板、触发条件、恢复动作与影响范围;为状态提供触发×状态矩阵;为转换提供输入到输出的流水线示例;为配置键提供校验、动态重载及行为影响追溯。

工作流程:阶段 1 为 SPEC 摄入与差距分析,解析各节、实体、配置键、状态、错误类与算法,构建扩展清单并向用户展示扩展计划;阶段 2 为针对性头脑风暴,每轮 3-6 个问题,聚焦校验边缘用例、错误消息细节、时序歧义与边界行为;阶段 3 起草 BLUEPRINT.md,包含文档头、系统上下文、实体目录、配置圣经、状态转换矩阵、时序规格、集成规格、错误目录、校验规则汇编、算法细节、边缘用例百科、交叉引用索引与实现清单;超过约 2500 行时可拆分 BLUEPRINT.md、ERROR_CATALOG.md、EDGE_CASES.md、SEQUENCES.md;阶段 4 自审,做机械翻译测试、覆盖检查、一致性检查与示例完整性检查,并输出评审摘要。修改时建议外科式应用并重跑自审、呈现变更日志。

限制:依赖 SPEC.md 存在;蓝图语言无关,不指定具体校验工具;避免复制粘贴、用散文替代表格、过度填充已足够详细的章节、指定技术栈以及无来源的孤立细节。