mcpField
P
planning-jira-tasks

planning-jira-tasks

github.com/b-mendoza开发355 次安装2 天前更新
代码仓库

关于 planning-jira-tasks

用于将 Jira 工单快照规划为任务文件的第二阶段编排器。它通过分阶段规划和验证调度专用 Agent，并保留产物以便重试和重新规划。

主要功能

  1. 01基于现有 Jira 快照规划
  2. 02调度专用规划 Agent
  3. 03验证各规划阶段
  4. 04保留产物以便续跑和评议
  5. 05仅重试未通过的阶段

适用场景

  1. 01将 Jira 工单拆分为任务
  2. 02根据评议或决策变化重新规划
  3. 03恢复未完成的规划流程

安装

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

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

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

包含的文件

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

flow-diagram.md
references/
dependency-and-branch-guide.md
dependency-prioritizer-template.md
execution-guide.md
external-sources.md
output-contract.md
re-plan-cycle.md
task-planner-template.md
task-planning-guide.md
validation-checks.md
subagents/
dependency-prioritizer.md
stage-validator.md
task-planner.md
task-validator.md

详细介绍

规划 Jira 工单任务

将 Jira 工单快照规划到 docs/<TICKET_KEY>-tasks.md。这是 Jira 规划工作流的第 2 阶段编排器：它负责路由各阶段、分派专员、保留阶段产物以便恢复和评审，并返回简洁的交接信息。

编排器在上下文中仅保留工作流状态、子 Agent 的判定、路径、计数和用户决策。详细约定、模板、验证检查以及有来源依据的背景信息，会在需要时从随附参考资料或可选的外部 URL 加载。

输入

输入必填示例
TICKET_KEY是JNS-6065
RE_PLAN否true
DECISIONS否SSO 决策更改任务依赖项

第 2 阶段由文件驱动。docs/<TICKET_KEY>.md 必须已作为 Jira 工单快照存在。

按需加载映射

需求加载内容
常规运行、分派负载、重试循环./references/execution-guide.md
最终产物约定、分支策略、子任务处理./references/output-contract.md
根据评审结果重新规划，或从阶段产物中恢复./references/re-plan-cycle.md
有来源依据的背景信息或当前平台语法./references/external-sources.md
子 Agent 专属指南、模板或验证检查仅从已分派的子 Agent 加载

本文件中的随附路径相对于此 SKILL.md；后续加载的文件，其路径相对于文件自身的位置。所有随附文件都会随软件包一起提供。 外部 URL 是可选的增强内容：仅在本地约定需要背景信息或当前语法时才获取；若无法访问网络，则根据随附参考资料继续操作。

子 Agent 注册表

子 Agent路径用途
task-planner./subagents/task-planner.md分解工单并起草第 1 阶段计划
dependency-prioritizer./subagents/dependency-prioritizer.md添加依赖顺序、优先级和分支名称
task-validator./subagents/task-validator.md验证已确定优先级的计划并附加 QA 结果
stage-validator./subagents/stage-validator.md检查前置条件、阶段间和最终结构门槛

工作流

路径适用情形下一步参考
常规未设置 RE_PLAN 或其值为 false./references/execution-guide.md
重新规划RE_PLAN=true 且有评审决策./references/re-plan-cycle.md，然后是 ./references/execution-guide.md

常规路径为：前置快照验证、第 1 阶段详细规划、第 1 阶段验证、第 2 阶段依赖项／分支规划、第 2 阶段验证、第 3 阶段最终验证报告、第 3 阶段验证、流水线后验证、交接。

请在磁盘上保留 docs/<TICKET_KEY>-stage-1-detailed.md、 docs/<TICKET_KEY>-stage-2-prioritized.md 和 docs/<TICKET_KEY>-tasks.md。这些文件是用于恢复、评审和定向重试的编排状态，不是实现产物。

仅使用定向修复循环。重新分派生成失败产物的阶段，只传递验证器的问题列表，仅重新运行失败的门槛；同一门槛失败 3 次后停止。

返回格式

仅返回本阶段的交接信息。只有在所有阶段及阶段验证门槛均通过时，才使用 PLANNING: PASS。

PLANNING: PASS | FAIL
TICKET_KEY: <TICKET_KEY>
File: <final file path or "not written">
Tasks: <N>
Branches: <N unique branch names>
Cross-cutting questions: <N>
Validation warnings: <N>
Failure category: PREFLIGHT | STAGE_1 | STAGE_2 | STAGE_3 | POSTPIPELINE | NONE
Reason: <one line>
Artifacts preserved: <comma-separated paths>

示例

输入：`TICKET_KEY=JNS-6065`
  1. 加载 ./references/execution-guide.md 以获取分派负载。
  2. 分派 stage-validator 执行 preflight；它返回 STAGE_VALIDATION: PASS。
  3. 依次分派 task-planner、dependency-prioritizer 和 task-validator，并在每个产物生成后进行验证。
  4. 分派 stage-validator 执行 postpipeline；它返回 STAGE_VALIDATION: PASS。
  5. 返回简洁的 PLANNING: PASS 交接信息，并附上保留的产物路径。

评论

支持 Markdown