SuperAPI AI 工具集

create-work-item-planning-skills

智能体与模型

查看项目

更新于 10-16 08:11

技能介绍

用途:在 bootstrap 之后,为仓库生成可重复的规划受理流程,从既有 bug 或 user-story ID 出发做证据收集与规划。生成的两个技能必须同时创建,不可只建一个:plan-bug-from-id、plan-user-story-from-id,它们共用会话接口,差异在证据、分析和计划就绪门槛。

主要能力:两个技能均为 Planner 专用,不得被其他智能体或通用工作流调用;要求传入源 ID,规范化为仅含字母、数字、_、- 的文件系统安全会话 ID,经外部跟踪器适配器或本地 Markdown 适配器解析,ID 缺失、重复、不可读或不符合模式时失败关闭。在配置的会话根目录下创建或恢复唯一会话文件夹,仅读写当前会话,记录来源类型、源 ID、适配器、检索时间戳、证据、决策和最终实施计划,并在最终交接中给出会话路径与适配器。plan-bug-from-id 需收集标题、描述、评论、验收标准、图片引用与讨论证据后分析可能原因,采用由窄到宽的因果门:先定最可能根因,再扩展到代码、配置、数据、外部依赖等因素,列出前两三个原因并附证据,等待用户选定后再产出计划,计划聚焦所选根因而非仅症状。plan-user-story-from-id 需收集标题、描述、评论、验收标准、epic、feature、相关工作项、图片引用与讨论证据,将验收标准与相关工作项视为计划关键证据,并在会话中保留歧义、缺失需求、依赖和未决问题,供 Planner 提出阻塞性澄清或说明继续理由。

使用方式:必须先确认仓库存在问题跟踪器契约,否则不得创建这两个技能。外部跟踪器适配器(GitHub、Jira、Linear、Azure DevOps、Notion 或其他已配置系统)需定义跟踪器名称、获批检索 MCP 或平台工具、支持的工作项类型、ID 格式、需检索字段、缺失 ID 行为、证据转会话 Markdown 规则;本地 Markdown 适配器需定义 issue 根目录、接受的 ID 模式、直接路径或索引查找、索引文件路径、必需 frontmatter 或标题字段、图片与附件处理、缺失与重复 ID 行为、证据复制规则。技能正文必须包含行内 #tool:agent/runSubagent 交接,检索工具细节写在子智能体提示或适配器契约中,不得放入技能 frontmatter;plan-bug-from-id 使用内置子智能体,plan-user-story-from-id 使用默认子智能体并留空 args.agentName。适配器名称须在技能正文中写明,未配置外部集成时使用仓库本地 Markdown 适配器,不得编造跟踪器 MCP 名称,不可用的跟踪器 MCP 只能作为建议记录。

限制:不得在生成技能中添加技能级 tools frontmatter,也不得添加 Planner 基线工具、跟踪器 MCP、文档 MCP、框架 MCP 或宽泛集成工具列表;不得覆盖其他会话;不得枚举或读取其他会话文件夹;不得复制密钥;工作项创建是另一技能,绝不创建规划会话;证据保存后从仓库正常规划流程的第一个规划门开始,仅跳过已由证据完全满足的访谈或澄清步骤;存在既有上下文词汇表和计划 schema 时应沿用。写入文件前检查既有约定,提出文件批次并等待明确批准,随后校验 frontmatter、无技能级 tools、必需的 runSubagent 交接、链接、会话 ID 规则、适配器选择、ID 检索及本地 Markdown 查找,并确认两个技能引用同一会话接口。