用途:作为工作项流程编排器,协调从初始获取到逐任务实现的完整 Jira 或 GitHub 工作项流程。当用户提供 Jira 工单或 GitHub issue 信息时使用。
主要能力:编排器只做三件事——思考(解读子智能体摘要与当前流程状态)、决策(选择下一阶段、门禁响应或恢复路径)、派发(把工作交给下游技能或工具子智能体)。直接工作仅限于读取本技能包、与用户对话和派发助手;任何涉及文件、工作项平台、git、代码库或网络的操作都委托出去。
流程阶段:阶段1获取工作项,阶段2规划任务,阶段3澄清与评审,阶段4创建子项,阶段5规划任务执行,阶段6澄清与评审,阶段7启动并执行;阶段5-7按任务重复,直到全部完成或用户停止。
平台检测:根据用户首个输入判断平台。JIRA_URL 匹配 https://<workspace>.atlassian.net/browse/<KEY>,或 TICKET_KEY 匹配 <PROJECT>-<N> 且 PROJECT 不含连字符时归为 jira,加载 ./references/jira-playbook.md;ISSUE_URL 匹配 https://<host>/<owner>/<repo>/issues/<N>,或 OWNER+REPO+ISSUE_NUMBER,或 ISSUE_SLUG 匹配 <owner>-<repo>-<N> 时归为 github,加载 ./references/github-playbook.md。无法匹配或存在歧义时,先提一个针对性澄清问题再派发。
使用方式:从输入检测平台并加载对应 playbook;按 playbook 规则派生工作流键 TICKET_KEY;以 TICKET_KEY 和 ACTION=read 派发 progress-tracker;根据进度摘要决定恢复点;以 TICKET_KEY、PLAYBOOK_PATH、PHASES 派发 preflight-checker;随后按阶段边界逐步推进。派发子智能体时读取其定义并传递绝对路径,只保留结论与下一步所需细节。
子智能体注册表:preflight-checker 校验依赖,artifact-validator 校验阶段前后置条件,progress-tracker 读写进度产物,status-checker 查询平台状态,codebase-inspector 汇总 git 分支与提交,code-reference-finder 定位符号与实现触点,documentation-finder 查找文档。
输出契约:每阶段或门禁后只返回简洁阶段摘要、下一项所需决策或确认、以及下次派发所需的文件路径、工作项标识或任务编号。
持久化记录:docs/<KEY>-progress.md、docs/<KEY>-task-<N>-progress.md 及各阶段产物,用于恢复,不由编排器提交。
限制:下游阶段技能是运行时依赖,若宿主运行时无法按名称调用所需技能,应在 preflight 停止并请用户安装或启用缺失依赖。外部 URL 为可选支持材料,与内置契约冲突时以内置契约为准。资料未提供具体安装命令、收费或平台支持范围等信息。