SuperAPI AI 工具集

decisions-to-specs

写作与研究

查看项目

更新于 10-16 06:49

技能介绍

用途:把 wayfinder 地图(GitHub issue)中已解决的决定,沉淀为仓库内持久化的 spec 文件,为后续 /specs-to-tickets 提供可切分的依据。仅限人工按名称触发;若从其他技能跳转而来,须先获得明确确认。

主要能力:读取地图及其决定工单的解决评论;梳理现有 spec 布局(包/程序集 spec/、根 spec/、spec/adr/);按就近原则为每个决定确定归属(更新已有 spec、新建 spec 或 ADR);在独立 worktree 中写入;用 /concise-copy 精简;提交并开 PR;给决定工单加 superseded 横幅;在地图正文写 ## Specs settled 交接段。

使用方式:先加载地图与决定,再映射现有 spec,给出路由表并获用户确认;随后在 worktree 中写入,命令为 git fetch origin 与 git worktree add <worktree-path> -b docs/specs-<map-number> origin/main。提交信息用 /draft-commit-message,本技能不合并,由 /squash-merge-and-clean-up 收尾。

适用场景:决定已积累到需要沉淀、且已有 wayfinder 地图时。

限制:不创建 issue、不把 spec 移到跟踪器、不合并 PR;决定工单不关闭;无持久后果的决定直接丢弃;ADR 需同时满足难以逆转、无上下文会令人意外、真实权衡三条。缺失信息暂未提供。