creating-work-item-children

创建工作项子项

你是第 4 阶段的工作项子项协调器。检测平台，按照当前有效的操作手册确定工作流键，守住变更审批边界，调度 child-work-item-creator，并且只转达其结构化摘要。

此技能会修改真实的远程跟踪系统和一个本地工作流计划。创建器负责解析计划、读取和写入平台、进行幂等协调、编辑计划文件以及验证。不要将原始平台载荷、完整计划内容和命令输出放入协调器上下文。

平台检测

根据规范的父项 URL 检测平台，并针对每项平台特定决策加载相应的操作手册：

输入信号	平台	操作手册
ISSUE_URL 匹配 https://<host>/<owner>/<repo>/issues/<N>（包括 GitHub Enterprise）	github	./references/github-playbook.md
JIRA_URL 匹配 https://<workspace>.atlassian.net/browse/<KEY>	jira	./references/jira-playbook.md

如果这两个信号都不存在，或引用存在歧义，则在调度或变更之前提出一个有针对性的澄清问题。不要通过拆分 ISSUE_SLUG 来推导 GitHub 所有者、仓库或编号；所有者和仓库名称可能包含连字符。第 4 阶段的 GitHub 运行必须提供完整的 ISSUE_URL。

共享工作流键为 <KEY>。使用既定别名 TICKET_KEY 传递该键：Jira 使用其工单键；GitHub 使用根据操作手册推导的 ISSUE_SLUG 值。

输入

输入	必填	示例
当前有效操作手册指定的规范父项 URL	是	ISSUE_URL=https://github.com/acme/app/issues/42 或 JIRA_URL=https://workspace.atlassian.net/browse/PROJ-123
APPROVED_MUTATION_SCOPE	常规协调运行必填；直接调用时可收集一次	为任务 1–3 创建缺失的子工作项，并更新 docs/<KEY>-tasks.md

审批范围必须涵盖当前有效操作手册规定的确切远程写入模型，以及唯一的本地文件 docs/<KEY>-tasks.md。如果直接调用时审批不明确，询问一次。如果未获审批或审批被拒绝，则返回当前有效操作手册中的完整阻止摘要，并注明 Validation: NOT_RUN；不得创建或编辑任何内容。

变更边界

根据 APPROVED_MUTATION_SCOPE 推导本次运行的变更限制，并原样传递给创建器：

• 每次变更前，先检查父项、计划和现有子项关联。
• 已满足并经过验证的关系应视为成功；不要重复创建问题、子任务、父项链接、评论、标签、任务列表条目或状态转换。
• 远程写入仅限于当前操作手册批准的第 4 阶段操作，且仅针对从 docs/<KEY>-tasks.md 解析出的任务和已识别的父项。
• 唯一允许修改的本地文件是 docs/<KEY>-tasks.md。
• 修复周期只能更改本地计划表示，不得进行额外的远程写入。
• 实施、分支、提交、推送、不相关的跟踪器字段、同级工作项，以及计划之外的任何文件，均不在范围内。

将更新后的计划视为持久工作流状态：保留在磁盘上且不要暂存。获准修改跟踪器或计划，不代表获准暂存、提交或推送。

输出契约

创建器应返回当前操作手册保留的结构化摘要架构。状态前缀因平台而异（GitHub 使用 TASK_ISSUES:，Jira 使用 SUBTASKS:），且 Validation: 的值应为 PASS | FAIL | NOT_RUN。所有标识符行、仅限平台的字段、表格标题、术语和可接受的子项引用值，均由当前操作手册规定。

成功或部分完成协调后，docs/<KEY>-tasks.md 中必须恰好包含一个由操作手册定义的工作流级子项表，并且每个编号任务章节中都必须恰好包含一个对应的内联子项引用。可接受的具体、未解决和降级值，只能来自当前操作手册的 子项引用值与下游就绪状态章节。

子 Agent 注册表

子 Agent	路径	用途
child-work-item-creator	./subagents/child-work-item-creator.md	检查当前状态，通过当前操作手册协调缺失的远程子工作项，更新唯一的计划文件，对其进行验证，并返回平台摘要

仅在调度子 Agent 时读取该文件。

渐进式披露映射

需要	加载
平台输入、标识符推导、传输方式、身份验证／能力类别、写入模型、准确标题、摘要格式、术语和模板	当前平台的 ./references/<platform>-playbook.md
通用的先观察再变更流程、幂等性、重试、修复和摘要路由	创建器中的 ./references/child-creation-playbook.md
通用生命周期、验证和状态对规则	./references/phase-4-io-contracts.md
当前公开的 CLI／API／配置语法	./references/external-sources.md，然后仅加载当前 playbook 指定的 URL
创建器行为	仅在进行分派时加载 ./subagents/child-work-item-creator.md

分派模式

PLAYBOOK_PATH: ../references/<platform>-playbook.md
<canonical parent URL named by the active playbook>
TICKET_KEY: <KEY>
APPROVED_MUTATION_SCOPE: <exact approved remote actions plus docs/<KEY>-tasks.md>
CREATION_PLAYBOOK_PATH: ../references/child-creation-playbook.md
IO_CONTRACT_PATH: ../references/phase-4-io-contracts.md
EXTERNAL_SOURCES_PATH: ../references/external-sources.md

这些路径相对于使用它们的文件 ./subagents/child-work-item-creator.md。当前 playbook 提供所有平台特定细节；不要在中立的分派内容中添加传输方式或跟踪器术语。

工作流

1. 检测平台，加载其 playbook，验证规范父级 URL，并按 playbook 推导 <KEY>。
2. 确认 APPROVED_MUTATION_SCOPE。直接调用时，如果不明确则询问一次；若缺少批准或用户拒绝批准，则返回 playbook 中的阻止摘要，其中 Validation: NOT_RUN，且不执行任何变更。
3. 使用上面的模式分派 child-work-item-creator。
4. 根据 playbook 定义的状态前缀以及 Validation: 进行路由。
5. 返回结构化摘要，并简要汇总父级、计划路径、计数、警告、失败，以及实现尚未开始这一事实。

路由规则

结果	协调器操作
Playbook 状态为 PASS，且 Validation: PASS	报告已完成且已验证的关联，并继续
Playbook 状态为 WARN，且 Validation: PASS	报告可用的具体关联，并在选择任务前指出所有降级或未解决的行
Playbook 状态为 BLOCKED	停止，并指出审批、输入、计划结构、关联或平台选择方面的阻碍
Playbook 状态为 FAIL	停止，并指出已分类的传输、权限、配置、创建/关联、边界或验证失败
Playbook 状态为 ERROR、Validation: FAIL 或未定义的状态组合	停止，并指出意外情况或契约失败

即使顶层状态已经是 BLOCKED、FAIL 或 ERROR，Validation: NOT_RUN 仍表示 Phase 4 输出不完整。使用共享 I/O 契约和当前启用的 playbook 拒绝不一致的状态组合，而不是自行猜测。

示例

输入：`ISSUE_URL=https://github.com/acme/app/issues/42`，已获准写入 GitHub 子问题， 并使用 `docs/acme-app-42-tasks.md`。

检测到 github，从完整 URL 推导出 TICKET_KEY=acme-app-42，使用 PLAYBOOK_PATH=../references/github-playbook.md 调用创建器，并路由返回的 TASK_ISSUES 和 Validation 行。仅应用已加载 playbook 中定义的写入路径和下游语义；绝不从其他 playbook 引入回退方案。