mcpField
C
creating-jira-subtasks

creating-jira-subtasks

github.com/b-mendoza生产力353 次安装2 天前更新
代码仓库

关于 creating-jira-subtasks

creating-jira-subtasks 是用于 Jira Phase 4 流程的编排技能。它提取工单标识，将原始 URL 交给 subtask-creator，并转达结构化结果；写入 Jira 和更新指定计划文件前必须获得批准。

主要功能

  1. 01提取工作区和工单标识
  2. 02指定写入操作须先获批准
  3. 03将 Jira URL 交给 subtask-creator
  4. 04依据状态和验证结果分流
  5. 05报告数量、警告与失败

适用场景

  1. 01根据已批准的计划创建或协调子任务
  2. 02通过工单 URL 分派 Jira 工作
  3. 03在实施开始前报告 Phase 4 结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/b-mendoza/agent-skills --skill creating-jira-subtasks

安装后在 Claude Code 中输入/creating-jira-subtasks确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

flow-diagram.md
references/
external-sources.md
phase-4-io-contracts.md
subtask-creation-playbook.md
subagents/
subtask-creator-templates.md
subtask-creator.md

详细介绍

创建 Jira 子任务

你是 Phase 4 Jira 子任务编排器。编排器负责三件事：从 JIRA_URL 推导标识符、使用原始 URL 调度 subtask-creator，以及向调用方转发结构化的 Phase 4 摘要。

子 Agent 负责解析计划、执行 Jira 操作、编辑计划文件和验证。编排器只保留结论、路径、数量、警告和失败信息。

仅当调用方或用户已批准创建 Jira 子任务以及对 docs/<TICKET_KEY>-tasks.md 的限定范围更新后，才运行此技能。常规编排会通过 APPROVED_MUTATION_SCOPE 传递该批准。如果直接调用且批准情况不明确，请询问一次是否批准；如果未获得批准或用户拒绝，则返回契约规定的受阻摘要，并标记 Validation: NOT_RUN。

输入

输入必填示例
JIRA_URL是https://workspace.atlassian.net/browse/PROJ-123
APPROVED_MUTATION_SCOPE否Jira subtasks plus docs/PROJ-123-tasks.md update approved

常规编排运行会包含 APPROVED_MUTATION_SCOPE。直接独立运行时，可在调度前向用户征求相同的批准。仅在本地推导信息，用于路由和报告。完整 URL 是传递给子 Agent 和支持 Jira 的工具的规范上下文：

  • 工作区： .atlassian.net 前的子域名
  • 项目： 工单标识符中连字符前的前缀
  • TICKET_KEY： 完整路径段，例如 PROJ-123

渐进式加载映射

仅在出现相应需求时，才读取每行所列的目标文件。加载路径相对于此 SKILL.md；切勿预先加载。

需求加载
Phase 4 产物结构、摘要字段或状态含义./references/phase-4-io-contracts.md
当前 Jira REST v3 语法、子任务配置、Atlassian 文档格式或技能维护理由./references/external-sources.md，然后仅获取最相关的 URL
创建或协调子任务./subagents/subtask-creator.md

外部 URL 是可选的即时来源。即使无法访问网络，本技能仍可依靠随附文件执行；子 Agent 和参考文件包含常规运行所需的本地指导。

子 Agent 注册表

仅在调度子 Agent 时读取其定义。

子 Agent路径用途
subtask-creator./subagents/subtask-creator.md将澄清后的计划与 Jira 子任务协调一致，并返回 Phase 4 摘要

工作流

  1. 确认存在 JIRA_URL。如果缺失或格式错误，则返回 ./references/phase-4-io-contracts.md 中的受阻摘要，其中包含 Parent: UNKNOWN、TICKET_KEY: UNKNOWN、Plan file: not updated、零计数以及 Validation: NOT_RUN。
  2. 推导用于本地报告的 TICKET_KEY，然后确认本次运行已获准写入 Jira 并限定范围更新计划文件。如果未获批准或用户拒绝，则返回相同结构的受阻摘要，其中包含推导出的 TICKET_KEY 和 Plan file: not updated。
  3. 仅在解读输出、验证 Phase 4 或说明所需产物结构时，才读取 ./references/phase-4-io-contracts.md。
  4. 读取 ./subagents/subtask-creator.md，并使用 JIRA_URL 和获批的变更范围调度它。获批范围仅限于创建或复用 Jira 子任务，以及修改 docs/<TICKET_KEY>-tasks.md。
  5. 根据返回的 SUBTASKS 和 Validation 行进行路由。
  6. 报告简洁的 Phase 4 汇总：父项、TICKET_KEY、计划文件路径、数量、警告、失败信息，并提醒尚未开始实现工作。

路由规则

结果编排器操作
SUBTASKS: PASS 且 Validation: PASS报告成功并继续
SUBTASKS: WARN 且 Validation: PASS报告可用的关联输出、可见警告，以及执行该任务前需要手动解决的任何 Not Created 行
SUBTASKS: BLOCKED停止并指出缺少审批、计划结构不安全、关联不安全或需要手动选择子任务类型
SUBTASKS: FAIL停止并指出致命的 Jira、配置、必填字段或验证失败
SUBTASKS: ERROR 或 Validation: FAIL停止并指出意外失败或本地契约失败

即使顶层状态已经是 BLOCKED、FAIL 或 ERROR，也应将 Validation: NOT_RUN 视为 Phase 4 输出不完整。

输出契约

仅返回子 Agent 的结构化摘要，以及一段面向调用方的简短汇总。完整的摘要架构见 ./references/phase-4-io-contracts.md。

不要在 Jira 报告中添加 GitHub 风格的写入模型或能力说明行。 此工作流在 Jira 中使用一种原生子任务关联路径。

示例

输入：`JIRA_URL=https://workspace.atlassian.net/browse/PROJ-123`
  1. 编排器提取 TICKET_KEY=PROJ-123，用于报告。
  2. 编排器向 subtask-creator 传递 JIRA_URL 和已批准的变更范围。
  3. 子 Agent 返回契约摘要，其中包含 SUBTASKS: PASS、 Validation: PASS、父项、计划路径、数量、警告和失败项。
  4. 编排器报告成功、创建和关联数量、任何警告或失败项，以及尚未开始实施。

评论

支持 Markdown