SuperAPI AI 工具集

to-spec-plus

智能体与模型

查看项目

更新于 10-23 16:18

技能介绍

To Spec Plus 是一个技能,作用是把当前对话上下文和代码库理解综合成一份规格(PRD),并发布到项目的 issue 追踪器。它不访谈用户——访谈通常已在 grill-me-plus 会话中完成,此技能只做综合整理。

若存在真正未解决的承重决策(即不解决就无法写规格的决策),不要猜测,也不要启动完整访谈。只通过 AskUserQuestion 询问该决策(推荐选项放首位,每个选项附权衡),或在多个决策悬而未决时建议先跑一轮 grill-me-plus。

管线位置:grill-me-plus/wayfinder-plus(决策)→ to-spec-plus(记录)→ to-tickets-plus(切分)→ implement-plus(构建)。

流程:

  1. 探索仓库:了解代码库现状,沿用项目领域词汇(如有 CONTEXT.md 可参考,由 domain-modeling-plus 维护),并遵守所涉区域的 ADR。
  2. 勾勒测试接缝:接缝是功能被测试的公共边界。优先复用现有接缝,尽量选最高层接缝,接缝越少越好,理想数量为一个。资料给出了 Laravel 接缝阶梯(由高到低):HTTP 边界(默认)、Livewire/Filament 组件、控制台命令、队列任务/监听器、Action/服务类、模型。随后通过 AskUserQuestion 与用户确认接缝,推荐项为建议接缝集,并给出高一档和低一档的替代方案及权衡。
  3. 撰写并发布规格:按模板写规格,先展示草稿,再以 ready-for-agent 标签发布到项目 issue 追踪器(创建 issue 属外部操作,须用户看过草稿后再发布)。追踪器快速路径:优先 docs/agents/issue-tracker.md,其次 AGENTS.md/CLAUDE.md 中的 ## Issue tracker 章节,再检测(Linear MCP → Linear;GitHub 远程 + gh → GitHub Issues;都没有 → .scratch/<feature-slug>/spec.md 下的 markdown 文件),并通过 AskUserQuestion 确认一次,可提议把选择持久化到 docs/agents/issue-tracker.md。

规格模板章节包括:问题陈述、解决方案、用户故事(长篇编号列表)、实现决策(模式变更、Eloquent 模型与关系、验证与授权、事件/监听器/任务/通知、API 契约、Filament/Livewire 影响、配置/特性开关、架构决策及理由;不写具体文件路径或代码片段,例外是能更精确表达决策的原型片段)、测试决策(约定接缝及覆盖行为、可模仿的既有测试、基本规则)、范围外、补充说明。

结束时打印管线状态块,列出实际适用的后续条件。