这个项目能做什么

## 概述 jira-integration 是用于 Claude Code 的插件，处理单个 Jira 问题从分支创建 → 方案设计 → 实现 → 测试 → 评审 → 本地合并的全过程，并将每个阶段的结果以 Jira 评论、附件、状态转换的形式记录。将多个问题放入队列依次处理完毕后，将通过/隔离结果汇总为一张异常报告，设计为人只需判断被隔离的事项。 ## 运行结构 由两个循环组成。 - 阶段循环（`auto`）：按 start → approach → impl+test → review 顺序推进一个任务。每个阶段由隔离的 sub-agent 执行，并为不同阶段分配不同的模型。评审门禁以结构化值判定设计与实现匹配率和 Critical 数量，未通过时由修复 agent 通过仅运行 lint、typecheck、相关测试的传感器循环（最多 5 次）收敛，然后各执行 1 次完整测试和 delta 重新评审。外层循环上限为 2 次。 - 任务循环（`loop`）：按顺序耗尽通过 `init` 配置的队列，每个任务执行 auto → 本地 `--no-ff` 合并 → 剩余 worktree rebase。若门禁未通过、阶段失败、合并/rebase 冲突，则仅隔离该任务并继续下一个。仅在出现认证（401/403）、MCP 连接、base 损坏等基础设施信号，或不同任务连续失败时，才整体中止。 控制流不是通过提示词解释，而是由 Workflow 脚本（`scripts/auto.workflow.js`）确定性执行，这一点在文档中已明确。 ## Jira 联动 一个问题键对应分支（`feature/<KEY>`）、worktree 和上下文文件。主仓库的 `.jira-context.json` 是容纳整个队列的 aggregate，各 worktree 下的则是该任务的状态。不同命令会产生状态转换（待办→进行中→评审中→完成）、评论、附件（approach/review 文档、测试报告）。隔离不会更改 Jira，仅记录为本地状态。 Jira 调用由仅使用标准库的 `scripts/jira-cli.py`（REST）负责，凭证存储在 workspace 级 `.jira-context.json` 的 `jira` 块中，并会从环境变量和旧版 MCP 设置自动迁移。MCP 服务器注册是可选项。 ## 主要命令 - 问题创建：`epic set/show/clear`、`discover`、`create` - 队列/自动化：`init`、`loop`、`auto` - 单个阶段：`start`、`approach`、`impl`、`test`、`review`、`merge`、`pr`、`done` - 查询/清理：`status`、`report`、`clean` - 其他：`/jira setup`、`/jira dashboard` ## 运行规则 根据工作任务规模判定为 L1/L2/L3，从而调整产出物篇幅和评审深度。若触及数据模型、事务边界、外部 API 契约、并发、安全边界，即使原为 L1 也会升级为 L2。`start` 仅对 approach 和 test 两个阶段可以建议跳过，impl、review、merge 不会被跳过。所有阶段都会记录在 `completedSteps` 中，重新执行时跳过已完成阶段。 ## 产出物与仪表盘 在 `docs/` 下积累 requirements、approach、test、review 文档以及 review-log、run-log（jsonl）。run-log 和 review-log 用作评审误报率、阶段耗时、修复频率、隔离原因等 harness 自身的观测数据。仪表盘在 `http://127.0.0.1:8765` 通过 SSE 实时显示每个 worktree 的卡片（进行阶段、工具调用、Jira 状态、blocks 图），仅限 localhost 访问且无认证。 ## 许可证 MIT。