AI-translated from English; not yet reviewed by a fluent editor. # 让获批功能经过 Jira 和经检查的 Claude Code 代码变更 > 将获批功能落实为真实的 Jira 史诗、全部故事和有实际意义的子任务。检查每项 Claude Code 变更，核实问题更新，并审查项目指引的处理决定。 By BIG CHANGE Editorial Published: 2026-10-20T13:23:38.288Z Updated: 2026-10-20T13:23:38.288Z Canonical: https://bigchange.ai/blog/claude-code-jira-approved-feature-guide ![Conceptual charcoal illustration of a developer at a standing counter reviewing a generic two-column code diff on an arm-mounted display.](https://bigchange.ai/api/media/file/claude-code-jira-feature-review-hero-v2.png) AI-generated conceptual illustration by BIG CHANGE. 一个获批功能在完成前，可能跨越三套系统：需求文档、Jira 问题层级以及代码仓库。Claude Code 可以协助起草和实现，但系统之间的对应关系仍需人工批准和直接检查。本指南帮助开发者或团队负责人推进一个真实功能，涵盖**每一个获批故事**、其原有测试、获授权的 Jira 更新，以及经过审查的项目指引处理决定。 这是依据文档编写的操作流程。BIG CHANGE 没有访问 Jira 项目、运行 Claude Code、修改代码仓库或测量功能交付时间。具体问题类型、字段、状态转换、命令及费用取决于你的项目和账户。 ## 关键变化 - **发生了什么变化：** 一个功能可以从获批需求一路追踪到真实的 Jira 父问题和全部故事，再到经过审查的代码、原有检查及获授权的问题更新。 - **为什么重要：** 问题映射、测试记录和直接从 Jira 回读的数据，能显示哪些获批工作已经完成、哪个故事仍未完成。 - **需要关注：** 项目特有的字段和状态转换、结果不确定的写入及失败的检查，都需要人工处理；Claude Code 的指引本身不构成工作授权。 ## 开始之前 选择一个已有负责人批准的简报、你有权修改的仓库，以及可执行的原始验收检查的功能。其实际工作应当需要在所选 Jira Cloud 项目中建立一个史诗层级父问题、全部获批故事，以及至少一个故事下有实际意义的子任务。如果工作没有真正的子任务，本指南所要求的完整结果就仍未达成；添加装饰性问题会使计划失真。记录请求人、批准权限方、来源修订版本、允许使用的数据、起始 Git 提交、隔离或回滚方式，以及有权审查代码和更改 Jira 状态的人。 检查已安装环境的[Claude Code 版本、身份验证和权限](https://code.claude.com/docs/en/permissions)。确认仓库中的 `CLAUDE.md` 只提供项目指引，并不授予修改、执行命令或发送数据的权限。决定哪些需求和代码可以交给 Claude、允许它执行哪些命令，以及本功能的用量上限。Claude Code 的使用可能占用订阅额度，也可能产生提供商费用；[Anthropic 的费用指南](https://code.claude.com/docs/en/costs)无法预先确定你的账单。 对于 Jira，取得浏览和创建相关问题类型的权限，并取得后续以获授权身份发表评论或转换问题状态的权限。私有脚本可以使用[Atlassian 文档中的电子邮件和 API 令牌方式](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis)；集成应用可能需要 OAuth。将凭据保存在私有密钥存储中，不要放入提示词、问题文本、`CLAUDE.md`、日志或版本控制。在向 Jira 发送需求前，先确定问题的可见范围。 操作过程中保留七类私有记录：`docs/feature-prd.md`、`ticket-plan.json`、仅追加的问题写入日志、`ticket-map.json`、每个故事的一份实现凭据、Jira 更新日志，以及回顾决定。这些是你的功能记录，不是 BIG CHANGE 提供或执行的文件。 ## 1. 批准一份内容明确的 PRD 将实际获批的功能简报交给 Claude Code，请它在起草 `docs/feature-prd.md` 前找出未解决的问题。文档需包含请求人及批准负责人、输入修订版本、问题与目标用户、范围与排除项、带编号的需求 ID、验收检查及其证据来源、非功能约束、Jira 项目和待解问题。由负责人对照原简报检查草稿，并批准一个明确的内容修订版本及其哈希值。在创建问题或修改代码前，解决实质性疑问。 哈希值为后续记录提供明确的来源依据。如果 PRD 改变，重新审查受影响的问题计划和检查；实现失败不能成为修改验收标准以获得通过结果的理由。 ## 2. 查明本项目的 Jira 层级和字段 使用获授权的**只读** Jira REST API v3 请求，分页读取 `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes`。对每一种拟用问题类型，分页读取 `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}`，查明创建时的必填字段和允许值。Atlassian 已将范围宽泛的 `GET /issue/createmeta` 操作标为已弃用，详见其[问题 API 参考文档](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/)。 确认本项目真实存在的史诗等效父层级、故事层级子问题和支持的子任务。Atlassian 介绍了[默认层级及其配置方式](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/)；类型名称和 ID 并不通用。检查项目的 Parent 字段在每个子层级如何运作，以及创建时需要哪些自定义字段或可见性设置。如果项目无法表示获批的问题结构，记录缺失的类型、字段或权限，并暂停创建。普通问题链接不等同于父子关系。 ## 3. 写入前审查完整问题计划 将每项 PRD 需求和验收检查映射到 `ticket-plan.json`。记录其 `planVersion`、PRD 哈希值、Jira 站点和项目键、本地运行 ID，以及计划批准人和批准时间。为每个拟建问题记录唯一的本地 ID、预期父问题本地 ID、已查明的问题类型 ID、项目必填字段、摘要、描述、需求与验收 ID、负责人及允许的可见范围。故事和子任务数量应由获批工作决定。每个子任务都必须在其真实所属故事下完成实际工作。 Jira REST v3 使用 **Atlassian Document Format (ADF)** 这种结构化 JSON 文档来表示多行问题描述和评论。依据获批内容准备这些文档，并在构造每次请求前检查站点返回的字段元数据。[问题 API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/)文档说明了创建操作，但不能为未知项目提供现成的字段对象。在执行任何 `POST` 前，应由人工批准完整结构、全部需求覆盖、父子关系和明确的写入目标。 ## 4. 先创建父问题，再逐项回读 通过 `POST /rest/api/3/issue` 创建获批父问题，再创建其故事，最后创建每个真实子任务。在**每一次**请求前，向私有日志追加一行，包含运行 ID、本地问题 ID、适用时已确认的父问题键、目标位置、准确获批请求的哈希值、UTC 尝试时间，以及 `pending` 状态。不要记录令牌。收到 HTTP 201 后，记录 Jira 返回的问题 ID 和键，再直接调用 `GET /rest/api/3/issue/{issueIdOrKey}`。将项目、类型、摘要、描述或 PRD 引用及父问题与获批计划对照。只有完成该回读后，才能将该行标记为 `confirmed`。父问题确认后，才能创建其子问题。 如果请求超时或响应丢失，将其标记为 `unknown`。按项目、时间、获批摘要和计划引用检查 Jira，直接打开可能匹配的问题，并请获授权负责人确认其身份。[Atlassian 提醒，写入后的搜索可能存在延迟](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/)。搜索不到结果不能证明创建失败。运行 ID 和日志有助于核对，但不会让服务器拒绝重复创建。切勿盲目重放结果不确定的 `POST` 请求。 直接读取已完成的问题结构并记录到 `ticket-map.json`：包括各本地 ID、真实 Jira ID 和键、规范问题 URL、项目、类型、父问题键、PRD 与验收 ID、回读时间，以及日志引用。将**全部**获批问题和标准与 PRD 对照。如果有问题缺失或父问题错误，停止进一步写入，使用项目经过审查的纠正流程。 ## 5. 实现并独立审查每个获批故事 按依赖顺序推进获批故事。对每个故事，记录 Jira 键、起始 Git 提交及分支或工作树、原始验收命令、允许的路径和命令。请 Claude Code 使用 [Plan mode](https://code.claude.com/docs/en/common-workflows) 将该故事的标准映射到仓库。由开发者检查计划，并授权范围明确的修改。故事边界让变更便于审查，并不意味着可以从功能中删去其余获批故事。 修改后，保留准确的差异、原始检查命令及其完整输出和退出状态、相关针对性测试，以及每个需求 ID 的判定。检查实际代码和日志。书面计划、生成文件或 Claude 声称测试通过，都不能证明变更可用。检查失败、发现意外密钥、依赖变更、外部写入或大范围重构时，暂停该故事；在获批范围内修复，并重新执行原始检查。由另一名代码审查者决定接受最终提交还是暂缓差异。为每个故事记录这一决定。[我们此前关于一项经审查的 Claude Code 变更的指南](https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide)涵盖较窄的代码审查环节；本指南的 PRD 和完整 Jira 结构则提供更广的功能边界。 ## 6. 核实获授权的 Jira 更新 对每个经过审查的故事，读取其当前 Jira 状态，并请求 `GET /rest/api/3/issue/{key}/transitions?expand=transitions.fields`。检查该身份实际可用的状态转换、目标状态、必填字段及允许值。随后，获授权负责人可以使用 `POST /rest/api/3/issue/{key}/transitions` 提交所选转换，并填入本项目确定的字段值。再次直接读取问题，确认新状态。代码检查通过本身不授权设置 Done、合并或部署。 在 Jira 更新日志中记录写入前状态、预期转换、操作身份、请求和响应。通过 `POST /rest/api/3/issue/{key}/comment` 发布事实性的 ADF 证据评论：被接受的提交或暂缓的差异、原始检查与针对性测试、剩余失败项及审查决定。从 Jira 的[评论 API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/)回读所创建评论的 ID 和正文。如果任一写入的响应不确定，考虑再次请求前先直接检查状态或评论。转换列表为空或必填字段不可用，代表需要与项目负责人解决的工作流或权限缺口，不是自行编造 ID 的理由。 ## 7. 决定是否修改 `CLAUDE.md` 文件 对照实际 PRD、问题、差异、测试、审查及 Jira 日志。请 Claude 做简短回顾，指出实际观察到的误解或缺失检查。由人工选择明确的指引修改，或记录不修改的决定，并记录审查人及时间。如果获批，只检查并提交这一份 `CLAUDE.md` 差异及其哈希值。[Anthropic 的记忆指南](https://code.claude.com/docs/en/memory)介绍了项目指引；此次审查不会自动授权未来工作。不要添加密钥，也不要将推测性的经验变成项目规则。 ## 完成条件与恢复处理 只有满足以下条件，功能才算完成：获批 PRD 修订版本对应直接确认的史诗、故事和子任务结构；**每个获批故事**都有起始状态、被接受的差异、原始检查及针对性测试证据和独立审查；每次获授权的 Jira 转换和证据评论都有直接回读；并且人工已经作出回顾决定。如果任何项目缺失，记录准确的剩余环节。[选择首个 AI 任务](https://bigchange.ai/blog/map-work-choose-first-ai-task-guide)的指南止于更早的任务选择和拟定检查阶段，不能证明这里的实现结果。 结果不确定的 Jira 创建操作应保持 `unknown`，直到人工核对其身份。父问题错误时停止创建子问题。测试失败时保留原验收标准。缺少状态转换或用量耗尽时，为负责人保留带日期的部分完成记录。仅向 Claude 和 Jira 提供获批的最少需求及客户数据，检查当前账户费用和权限，并为人工代码审查预留资源。本指南说明一条有条件的工具操作路线，不报告 BIG CHANGE 已完成的功能、Jira 写入、模型运行、实测节省、合并或部署。 ## 来源与延伸阅读 - [Atlassian：Jira Cloud REST API v3 问题操作](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/)：限定范围的创建元数据、问题创建和读取，以及状态转换操作。读者项目中的字段和 ID 必须在该项目中查明。 - [Atlassian：问题评论](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/)：ADF 评论创建及回读。权限和实际响应仍取决于具体站点。 - [Atlassian：搜索与核对](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/)：解释为何写入后立即搜索不到结果，无法确定一次结果不明的创建操作是否成功。 - [Atlassian：问题类型层级](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/)：默认层级和配置方式；仍需检查所选项目的结构。 - [Anthropic：Claude Code 工作流程](https://code.claude.com/docs/en/common-workflows)、[权限](https://code.claude.com/docs/en/permissions)、[记忆](https://code.claude.com/docs/en/memory)以及[费用](https://code.claude.com/docs/en/costs)：规划、修改授权、`CLAUDE.md`指引及用量。这些文档并不记录本功能的一次实际执行。 ## Sources - [Atlassian Jira Cloud REST API v3 问题](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/) — 说明限定范围的创建元数据、问题 POST/GET 及状态转换；宽泛的创建元数据操作已弃用。项目字段、ID 及允许的转换必须来自读者的站点。 - [Atlassian Jira Cloud REST API v3 问题评论](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/) — 说明 ADF 评论创建和回读，并受实际权限限制。本指南没有发布评论。 - [Atlassian 搜索与核对](https://developer.atlassian.com/cloud/jira/platform/search-and-reconcile/) — 说明搜索的最终一致性；创建响应不确定后，搜索未命中不能证明问题不存在。 - [Atlassian 配置问题类型层级](https://support.atlassian.com/jira-cloud-administration/docs/configure-the-issue-type-hierarchy/) — 解释默认及可配置层级。必须直接查明所选项目的层级及 Parent 的行为。 - [Atlassian REST API 基本身份验证](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/) — 说明私有简单脚本使用电子邮件加 API 令牌的方式，以及与集成应用的区别；凭据必须保持私密。 - [Anthropic Claude Code 常见工作流程](https://code.claude.com/docs/en/common-workflows) — 说明 Plan mode 和编码工作流程模式；不能证明读者已完成实现或检查。 - [Anthropic Claude Code 权限](https://code.claude.com/docs/en/permissions) — 说明实际工具权限及批准机制；仅有 CLAUDE.md 指引，不授权执行命令或写入。 - [Anthropic Claude Code 记忆](https://code.claude.com/docs/en/memory) — 解释 CLAUDE.md 项目指引；拟议的回顾修改需要人工审查，并非自动学习。 - [Anthropic Claude Code 费用](https://code.claude.com/docs/en/costs) — 用量及计费因方案和提供商而异；本指南仅依据文档，没有测量费用或节省。