SuperAPI AI 工具集

planning

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:当任务描述不充分、需要先出规格(spec)与工作包(work-package)计划,或需要将工作记录到 Linear 时使用本技能(Clarify + Spec + Track)。适用于规划、规格、澄清请求、工作包编排,或用户明确要求提供计划。

路由与边界:若主要任务是创建或更新技能,应优先使用 skill-creator,仅做纯计划回复时才用 planning;若请求转向实现/构建工作,应在澄清范围并锁定假设后交给 coding。打开参考文件时使用完整仓库路径,如 skills/planning/references/...,失败则用完整路径重试一次。若触发条件明确匹配,先打开对应参考文件再起草计划/规格;若需先问 1-2 个澄清问题,则先问再打开。若有字数或长度限制,保持简短并尽量减少额外读取。

Linear 状态流转:所有 Linear 状态流请求均视为规划工作,加载 skills/planning/references/linear-mcp-ops.md,将生命周期语义映射到团队状态,并为每次流转记录理由与评论。

路由顺序(元数据优先):1)工作包执行或继续(docs/workpackages/...、docs/review/workpackages_,或明确的工作包执行指令);2)显式 Linear 生命周期或流转操作;3)实现意图但缺少必要范围/验收约束;4)无显式工作包执行的规格优先迭代规划;5)回退到澄清。冲突规则:工作包与 Linear 线索同时出现时,先走工作包路由;除非明确请求流转操作,Linear 上下文检查保持只读。注意 trigger_phrases 仅为词汇加权提示,不应视为字面匹配门槛。若存在工作包提示,遵循 skills/planning/references/spec-driven-iterative-builder.md,并保持 docs/specs/ 与相关工作包文件同步。

参考文件:ask-questions-if-underspecified.md(最少澄清问题流程,含快速触发测试)、spec-driven-iterative-builder.md(规格优先迭代交付,含工作包集成模式)、linear-mcp-ops.md(Linear MCP 操作与头脑风暴记录)。

限制:资料未提供具体定价、平台、安装命令或额外功能细节。