SuperAPI AI 工具集

frame

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:frame 用于在 DRAFT 流程的 F 阶段把实现工作拆分为纵向切片(vertical slice)计划。每个阶段都要端到端横跨所有受影响层,形成可测试的集成路径,而不按“先全部数据库、再全部 API、最后全部 UI”的横向方式推进。第一阶段是曳光弹,即穿过每一层的最薄可能切片。

主要能力:定义曳光弹阶段;定义后续纵向阶段(建议共 3–5 个,超过 5 个提示范围过大,可考虑拆分);为每个阶段写明涉及组件、测试策略、验证门和验收标准;梳理阶段顺序与依赖,设计最大并行度;对跨切面关注点(认证、日志、错误处理)在需要它们的纵向阶段内建立。

使用方式:先定位输入——对齐文档优先从对话上下文获取,否则回退到 design-docs/NN-name.alignment.md,若不存在则询问是否运行 alignment;研究文档为可选参考,检查上下文或 design-docs/NN-name.research.md。随后按五步处理:定义曳光弹、定义后续阶段、细化每个阶段、排序与依赖、写入 artifact。产物保存到 design-docs/NN-name.frame.md,命名前缀与现有 artifact 一致,提交用户审阅,按需修订。用户批准后转入 tasks 以分解为可跟踪工作项。

适用范围与例外:适用于需要端到端可测试路径的实现规划。宽泛重构是例外——这类机械改动波及整个代码库,无法让纵向切片保持绿色,应按 expand–contract 排序:expand 在旧形式旁加入新形式,migrate 按爆炸半径分批迁移且可并行,contract 在无调用方后删除旧形式;若单批也无法保持绿色,则在共享集成分支上保留同一顺序并增加最终 integrate-and-verify 阶段。

限制:frame.md 是活动 artifact,实现揭示计划有误时可更新,移入 completed/ 后才不可变;必须持久化到磁盘,tasks 会链接回它;只作大纲,不写函数体或生产代码,签名与类型定义在澄清边界时可接受;一个倡议只创建一个 frame。其他平台、收费或价格信息暂未提供。