从 Issue 到 PR:Loki Mode 自动处理 GitHub、GitLab 与 Jira 任务的完整流程
从 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。
运行详情:每个阶段都可检查
运行期间,你可以随时在 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/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 dashboard 即可打开本地管理界面(默认只监听 127.0.0.1),所有运行的结果、回执、成本都在这里集中呈现:
loki control serve # 启动 Control Plane 服务
loki control status # 查看状态
任务以看板形式组织为 Pending / In Progress / Completed / Failed 四列;对于 BLOCKED(等待你回答)的运行,面板里内置了回答输入框,也可以直接用 loki answer --text "..." 续跑。
在较大的运行中,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。



