SuperAPI AI 工具集

create-spec

智能体与模型

查看项目

更新于 10-16 06:20

技能介绍

用途:create-spec 是 /create-ticket 的姊妹技能。工单面向人类提问,而规格面向无人值守运行的智能体,因此规格必须携带对话中已得出的全部答案。队友应用 agent:implement 标签后,软件工厂即接手实现。

主要能力:规格以 issue:spec 标签提交,作为单个拉取请求交付,可独立或作为子议题的父级,始终基于当前默认分支且不等待其他规格。子议题是规格的原生 GitHub 子项,按有序序列排列:智能体执行标 issue:AFK,人类执行标 issue:HITL,并通过原生依赖被其等待的兄弟议题阻塞。规格分支为 spec/<n>,承载项目上下文记录与后续代码。

规格内容:以“冷读”为标准,智能体仅凭仓库和规格即可无提问地打开拉取请求。需包含产品(问题、方案、覆盖全部行为的用户故事)、每项决策(选择、否决及原因)、发现(事实与陷阱及来源)、技术形态(模块、接缝、契约、数据形状)、验证(智能体在开 PR 前及所有者在合并后的检查)、所有者步骤与范围外内容。对话未定的选择留给智能体。

使用方式:流程为确认理解已定、收集记录(调用 /project-context)、评估规模、起草到临时目录的 markdown 文件并做冷读、等待批准、提交、交接。提交命令如 gh issue create --label issue:spec --title "<title>" --body-file <spec.md>;有来源时加 --blocking <origin>;有记录时创建 spec/<n> 分支并提交推送;子议题用 gh issue create --parent <n> --label issue:AFK --blocked-by <numbers> 等。

限制:标签须已存在,缺失时停止并告知用户,创建标签由用户决定;提交前需用户批准;密钥只写名称不写值;规格可等待数月,路径与行号会过时,仅在决策即路径时才命名路径。