用途
jira-tickets 用于把 PRD 或规格文档落成可直接执行的 Jira 工单。它的目标是:写出的每张工单,一个只读该工单的开发人员就能直接接手。它通常放在 prd-writer 之后使用。
主要能力
- 输入收集:读取 PRD(通常在 docs/prd/*.md);若没有 PRD 且需求模糊,建议先用 prd-writer。同时需要 repo 地图(哪个仓库负责什么);如存在影响分析报告则一并使用,若功能涉及共享模型或 API 却没有报告,先运行 impact-analysis 或在工单上标注风险。还需一次性询问 Jira 项目 key 以及团队用故事点还是小时,默认故事点(1、2、3、5、8)。
- 切分工单:一个功能对应一个 Epic,工单挂在 Epic 下;工单按 repo 划分,跨后端与前端的变化至少拆成两个互有依赖的工单;尽量纵向切分,让单张工单交付可测试成果(如端点加测试),而不是按“写模型”“写视图”“写测试”横向拆;有独立部署风险的改动(大表迁移、回填、共享 API 契约变更)单独建票;超过 8 点的工单要拆分。
- 工单内容:每张工单包含摘要(如 [backend] Add void endpoint for invoices)、Epic、Repo、Labels、估算、上下文(一两句说明原因并链接 PRD 章节)、要构建的内容、验收标准、影响范围、依赖关系(blocks / blocked by,双向一致)以及建议流程(如 impact-analysis → django-feature → test-writer → pr-description)。
- 估算指南(团队有自己标准时可调整):1 = 简单、有已知模式;3 = 约一天、单个应用;5 = 涉及多个文件或不熟悉区域;8 = 多天或有风险。未测试的遗留代码上调一档。
使用方式
- 收集 PRD、repo 地图、可用的影响分析报告,并确认项目 key 与估算单位。
- 按功能、仓库、可测试性切片,识别独立部署风险与依赖。
- 逐张撰写工单,包含验收标准、影响范围与依赖。
- 先以表格展示完整列表(key 占位、摘要、repo、估算、blocks/blocked-by)供开发人员修改确认,未经确认不得创建工单。
- 创建:若已连接 Jira MCP(Atlassian 工具可用),确认项目 key 后创建 Epic、工单和问题链接,并报告已创建的 key;若无 Jira 访问权限,则写入 docs/prd/<slug>-tickets.md 工单文档,以及 <slug>-tickets.csv(列为 Summary、Issue Type、Description、Labels、Story Points、Epic Link),供 Jira CSV 导入,并提示开发人员下次可配置 Atlassian MCP 实现自动化。
适用场景
已有较完整 PRD、需要将其拆成可执行 Jira 工单的团队;多仓库项目需要按 repo 划分任务并理清跨仓库依赖;需要为共享模型或 API 改动评估并标注影响范围的场景。
限制
每张工单必须有验收标准与 repo,没有例外;依赖必须双向对应;影响范围要具体到消费方、表规模、端点,不能泛泛而谈。缺乏 PRD 或影响分析时,技能会建议先行补齐或标注风险。Jira 自动创建依赖 Atlassian MCP 连接,否则仅能输出文档与 CSV。