从 Issue 到 PR:Loki Mode 自动处理 GitHub、GitLab 与 Jira 任务的完整流程

原创2026-10-15 07:13:411,625 阅读

从 Issue 到 PR:Loki Mode 自动处理 GitHub、GitLab 与 Jira 任务的完整流程

Loki Mode 是一个自主软件工厂(Autonomous Software Factory):把 GitHub、GitLab 或 Jira 上的一条 Issue 丢给它,它会自动完成编码、测试验证,最后交付一个可直接审查的 Pull Request(PR),并附上一份任何人都能离线复核的签名回执(Signed Receipt)。整个过程运行在你自己的机器上,使用你自己的 Claude、Codex 或 OpenCode 密钥。本文将带你完整走一遍这条「从 Issue 到 PR」的自动化流水线。

一条命令打通的任务流水线

Loki Mode 的核心工作流可以概括为 5 个阶段:

阶段 说明
Intake(接入) 解析 Issue 的标题、正文与验收标准
Plan(规划) 先根据任务写出检查项,再动手写代码
Implement(实现) 调用编码模型(Claude、Codex 等)完成代码修改
Verify(验证) 运行测试,只声称真正跑过的检查
Seal(密封) 生成 Ed25519 签名回执,打开 PR

每次运行结束时只会落在 6 种结果之一:VERIFIED、ALREADY_SATISFIED、FAILED、BUDGET_STOP、BLOCKED 或 STALLED,含义详见 docs/exit-codes.md。

快速安装:从安装到首跑只需 3 步

Loki Mode 通过 npm 发布,安装非常简单:

npm install -g loki-mode
export ANTHROPIC_API_KEY=sk-...   # 配置一个模型密钥
loki doctor                       # 体检:检查依赖与登录状态

loki doctor 会列出缺失的依赖(Python 3.8+、Node.js 20+、git、jq、curl),全部就绪后退出码为 0。不想先安装、只想看看真实运行效果,可以执行 npx loki-mode tour,它会离线打印一份历史构建的真实回执,无需密钥、不产生费用。

如果你希望阅读源码,可以克隆仓库 git clone https://gitcode.com/gh_mirrors/lo/loki-mode 来查看 autonomy/ 目录下的引擎实现。

三种任务入口:GitHub、GitLab 与 Jira 都支持

Loki Mode 的 Issue 获取层对多个平台做了统一抽象,源码位于 autonomy/issue-providers.sh。你只需把引用丢给它,它会自动识别来源:

平台 入口写法示例 前置条件
GitHub loki owner/repo#123 或 Issue 完整 URL gh CLI 已登录
GitLab 带 /-/issues/N 路径的 Issue URL glab CLI 已安装
Jira PROJ-123 或 Jira Browse 链接 设置 JIRA_API_TOKEN 与 JIRA_URL 环境变量

识别逻辑在 detect_issue_provider 函数中:按域名(gitlab.、.atlassian.net、github.com)或引用格式(PROJ-123 这类 Jira 票据号)分流到对应平台的抓取函数。

解析阶段做了哪些事

抓到 Issue 后,autonomy/issue-parser.sh 会从正文中结构化地提取 4 类信息:

  • 问题描述:识别 Problem / Description / Summary 段落
  • 验收标准:Acceptance Criteria 章节或正文中的复选框清单
  • 技术需求:Technical / Implementation 章节,以及 API、数据库等关键词
  • 优先级与类型:从 label 推断(bug / feature / docs 等)

这些验收标准会被持久化到 .loki/state/issue-context.json,成为后续验证阶段的对照依据——Loki Mode 明确知道自己"答应了什么",而不是凭印象收尾。这条链路的设计文档见 docs/ISSUE-TO-PR-GOLDEN-PATH-PLAN.md。

运行详情:每个阶段都可检查

Loki Mode Control Plane 运行详情页:从 Issue 到 PR 的阶段时间线与验证回执

运行期间,你可以随时在 Control Plane 面板里查看每个阶段的事件时间线:intake 拉取 Issue、plan 建立验收范围、implement 在隔离 workspace 编辑代码、verify 运行测试、seal 密封回执。即使运行失败(如图中 FAILED),面板也会如实展示失败发生在哪一步、原因是什么——这是它与传统"黑盒代理"最大的区别:每个阶段都留有可检查的产物。

常用控制参数:

  • --no-pr:只构建并验证,不打开 PR
  • --max-cost <usd>:单次运行成本上限,超限自动停止(结果为 BUDGET_STOP)
  • --provider <name>:指定编码模型提供方

一份 60 秒能审完的 PR

PR 描述专为快速审查设计,固定包含 4 个部分:Issue 要求了什么、改了什么以及为什么、如何测试的,以及最重要的 NOT PROVEN(未验证清单)——诚实地列出哪些检查没有运行。没有通过验证的运行只会打开 Draft PR,不会冒充完成。

签名回执:任何人都能离线复核

Loki Mode 签名回执面板:VERIFIED 判定与回执密封状态

每次运行结束,回执文件写入 .loki/runs/<run-id>/receipt.json,用本机 Ed25519 密钥签名。复核只需一条命令:

loki verify            # 校验最新运行的回执

它会重新计算哈希、验证签名、并对照运行的事件日志,输出 VERIFIED / TAMPERED / UNCHECKED / UNSIGNED 四种判定。需要强调的是:签名证明的是来源与完整性(这份回执确实由持有密钥的一方产生且未被篡改),而不是代码无 bug——这个边界在 docs/SIGNED-RECEIPTS.md 中被明确界定。回执的组装逻辑见 autonomy/lib/proof-generator.py。

Control Plane:统一管理所有任务

Loki Mode 任务队列看板:Pending、In Progress、Completed 与 Failed 四列任务状态

执行 loki dashboard 即可打开本地管理界面(默认只监听 127.0.0.1),所有运行的结果、回执、成本都在这里集中呈现:

loki control serve     # 启动 Control Plane 服务
loki control status    # 查看状态

任务以看板形式组织为 Pending / In Progress / Completed / Failed 四列;对于 BLOCKED(等待你回答)的运行,面板里内置了回答输入框,也可以直接用 loki answer --text "..." 续跑。

Loki Mode 多智能体面板:不同模型的工程师、测试与安全审查代理协同工作

在较大的运行中,Loki Mode 会从专家池里按改动文件与 diff 匹配度挑选评审者(如安全审查、QA 测试代理),由 agents/types.json 定义类型池。

新手常见问题

Q:模型密钥怎么配置? 环境变量 ANTHROPIC_API_KEY 即可起步;也支持已登录的 Claude Code CLI,或通过 --provider 切换 Codex、Cline、Aider、OpenCode 等实验性提供方。

Q:运行卡在 BLOCKED 怎么办? 说明交付契约无法按字面满足,Loki Mode 会停下来只问你一个问题,而不是擅自猜测。用 loki answer [run-id] --text "..." 回答后它会继续。

Q:Jira 需要哪些配置? 两个环境变量:export JIRA_API_TOKEN=你的token 和 export JIRA_URL=https://你的组织.atlassian.net,然后直接 loki PROJ-123 即可。

Q:想限制花费? 加 --max-cost 5,费用触顶即停,结果为 BUDGET_STOP,不会产生超支。

总结

Loki Mode 把「Issue → 规划 → 实现 → 验证 → 回执 → PR」这条链路完全自动化,同时用验收标准持久化、NOT PROVEN 清单和可离线复核的签名回执守住诚实底线。无论是 GitHub 的 bug 单、GitLab 的需求项还是 Jira 的票据,现在都只需一条 loki 命令,剩下的交给流水线。更多细节可查阅 docs/v10/GUIDE.md 与 docs/v10/CONTROL-PLANE.md。

登录后查看全文
loki-mode