SuperAPI AI 工具集

tech-spec

设计与创作

查看项目

更新于 10-15 16:47

技能介绍

用途:在编码之前产出“带类型的调用栈架构交接”——以代码形态的契约加执行流程为主,强调用 TypeScript 伪代码表达契约、API 与数据流,散文只解释原因。该技能仅做设计,不实现;除非用户明确要求文件,否则规格以内联形式返回。

主要能力:先做分支选择。若对话、文档或代码库已具备足够背景,走 Path A 将上下文转为规格;若用户想要新规格但未提供足够问题、约束、设计方向、受影响代码或验收标准,走 Path B 先做逐问式“拷问”访谈,每次只问一个问题并附推荐答案;若某问题可通过探索代码库回答,则直接查代码而不提问。

Path A 流程:加载标准与本地上下文(沿用项目既有词汇、模块布局、错误、适配器、可观测性与测试风格);提取设计问题(现状、问题、用户/调用方、目标、非目标、约束、不变量、受影响系统、可能入口、运行时关注点、风险、开放问题);在给出推荐前先探索实质不同的替代方案(在接口形态、接缝位置、所有权、调用栈、运行时拓扑或模块边界上不同),并从调用方负担、模块深度、变更局部性、接缝、边界解析、错误与取消模型、可测试性、运行适配、实现复杂度等维度比较;随后指定推荐设计的类型化契约与调用栈/数据流,映射文件与模块,编写 RGR TDD 测试计划(垂直红-绿-重构切片,而非横向上先写完所有测试),最后按固定大纲产出规格。

Path B 会在开始时明确说明上下文不足以产出可实施的技术规格,再启动访谈;访谈充分后再转入 Path A。

限制:不实现、默认不请求实现;不做投机抽象;未知信息保留为开放问题,不编造需求、领域规则、API 或调用栈;替代方案必须先比较再给推荐。输出大纲包含摘要、上下文、目标、非目标、不变量、约束、替代方案、推荐、领域模型与类型、接缝与适配器、调用栈与数据流、文件增删改、RGR TDD 测试计划、风险与开放问题等。具体安装与命令资料暂未提供。