名称: pm-ticketing-integration 版本: “1.0.0” 描述: 票务驱动开发协议 使用场景: 提及工单ID、问题URL、工作跟踪 类别: pm-workflow 标签: [tickets, integration, workflow, pm-required]
票务集成协议
检测规则
PM从以下检测工单上下文：
- 工单ID模式：
PROJ-123,#123,MPM-456,JJF-62 - 工单URL：
github.com/.../issues/123,linear.app/.../issue/XXX - 显式引用：“处理工单”, “实现问题”, “修复bug #123”
- 会话启动上下文（首次用户消息带工单引用）
关键执行
PM绝不能直接使用这些工具 - 总是委托给工单代理：
- ❌ PM使用WebFetch访问工单URL → 委托给工单
- ❌ PM使用
mcp__mcp-ticketer__*工具 → 委托给工单 - ❌ PM使用任何工具访问工单 → 仅委托给工单代理
委托规则：所有工单操作必须委托给工单代理。
票务驱动开发协议 (TkDD)
当检测到工单时 (PROJ-123, #123, 工单URL, “处理工单”)：
PM必须执行此工作流
1. 工作开始 → 委托给工单：
Task:
agent: "ticketing"
task: "开始在工单 {ticket_id} 上工作"
acceptance_criteria:
- 将工单转移到'进行中'
- 添加评论："Claude MPM开始工作"
- 确认状态变更
2. 每个阶段 → 评论交付物：
Task:
agent: "ticketing"
task: "更新工单 {ticket_id} 的进度"
context: |
阶段完成：{phase_name}
交付物：{deliverable_summary}
acceptance_criteria:
- 添加带阶段完成详情的评论
- 包括提交/PR链接如适用
3. 工作完成 → 转移到完成/关闭：
Task:
agent: "ticketing"
task: "完成工单 {ticket_id}"
context: |
工作摘要：{summary}
QA验证：{qa_evidence}
文件变更：{file_list}
acceptance_criteria:
- 转移到'完成'或'关闭'
- 添加全面的完成评论
- 链接PR如创建
4. 障碍 → 评论障碍详情：
Task:
agent: "ticketing"
task: "报告工单 {ticket_id} 的障碍"
context: |
障碍：{blocker_description}
影响：{impact}
等待：{dependency}
acceptance_criteria:
- 更新工单状态到'受阻'
- 添加障碍详情评论
- 通知相关利益相关者如适用
带工单上下文的文档路由
当提供工单上下文时
当用户以工单引用开始会话：
- PM委托给工单代理以附加工作产品
- 研究结果 → 作为评论附加到工单
- 规格 → 作为文件或格式化评论附加
- 仍在
{docs_path}/中创建本地文档作为备份 - 所有代理委托包括工单上下文
当无工单上下文时
- 所有文档保存到
{docs_path}/（默认：docs/research/） - 无工单附加操作
- 命名模式：
{topic}-{date}.md
工单上下文传播
当检测到工单时，PM在所有委托中包括工单上下文：
Task:
agent: "{any_agent}"
task: "{task_description}"
context: |
工单：{ticket_id}
工单摘要：{summary_from_ticketing_agent}
{other_context}
acceptance_criteria:
{criteria}
这确保所有代理知道工作是工单驱动的，并可引用它。
示例TkDD工作流
用户："处理工单 PROJ-123"
↓
PM委托给工单：获取工单详情
↓
PM委托给工单：转移到'进行中'，评论"工作开始"
↓
PM委托给研究：调查方法（带工单上下文）
↓
PM委托给工单：评论"研究阶段完成：{findings}"
↓
PM委托给工程师：实现功能（带工单上下文）
↓
PM委托给工单：评论"实现完成：{files}"
↓
PM委托给QA：验证实现
↓
PM委托给工单：转移到'完成'，评论"工作完成：{summary}"
违规预防
电路断路器：PM直接使用工单工具触发：
- 违规#1：⚠️ 警告 - 必须立即委托
- 违规#2：🚨 升级 - 会话标记为审核
- 违规#3：❌ 失败 - 会话不合规
此执行确保PM保持纯协调角色。