Loki Mode
把规格转为经验证代码与可复核交付凭证。
这个 Agent 能做什么，适合哪些场景？
Loki Mode 是一个从需求规格驱动的软件构建与验证 CLI。它接受 PRD、GitHub Issue、OpenAPI/JSON/YAML、纯文本 brief 等输入，通过 Bash 编排的 RARV 循环执行 Reason、Act、Reflect、Verify。运行会生成 Git 仓库中的源代码、测试、配置、Docker Compose 文件、CI/CD 配置、审计日志及 `.loki/proofs/<run_id>/` 下的 Evidence Receipt。该项目提供 `loki` CLI、Python 仪表盘、跨项目记忆系统，以及可由 `loki mcp` 启动的 MCP server。它可以生成部署配置，但文档明确说明 `loki deploy` 只输出部署命令，不会自行执行云端 CLI 或 `git push`。
使用 loki start <spec> 读取并标准化 Markdown、JSON、YAML/OpenAPI、GitHub Issue、Jira、GitLab 或 Azure DevOps issue 等规格输入，再由 autonomy/run.sh 的 run_autonomous() 执行 RARV 循环。它按复杂度组合 41 个角色规格，运行静态分析、测试、盲审、反迎合检查、mock 完整性、测试变异、文档覆盖和 Magic Modules 辩论等 8 个质量门。完成时，Loki 将 diff 的 base/head SHA、diff_sha256、测试和构建命令及退出码、门禁结果写入 Evidence Receipt；可通过 loki proof list、loki proof show <id> 与 loki proof verify <id> 检查。loki verify 还能对任意分支或 PR diff 运行构建、测试、静态分析、密钥扫描和依赖审计，并将机器可读证据写入 .loki/verify/evidence.json。对已有代码库，loki modernize heal <path> --assess 会先以只读方式产出语言、成熟度、技术债和按爆炸半径排序的建议。
- 需要把一份 PRD 或一句产品需求交给 CLI，并希望最终获得代码、测试和可复核 diff 证据的小型产品团队。
- 维护多年旧仓库的工程团队，可先运行 `loki modernize heal ./repo --assess` 评估技术债而不修改文件。
- 需要把 OpenAPI、GraphQL 或 Postman 合约拆成逐操作检查项的 API 团队。
- 希望在 PR 审查中附带测试、diff 哈希和门禁结果，而不只依赖代理自述完成状态的代码审查者。
- 使用 Claude Code 为主、但需在 Cline、Codex、Aider 或 opencode 间保留切换和故障转移路径的开发者。
这个 Agent 有哪些优点和局限？
- Evidence Receipt 将 diff 哈希、实际测试命令与退出码、构建结果和门禁结论写为可重新验证的文件，并明确区分确定性事实与 AI 判断。
- `loki verify` 可独立检查任意分支或 PR diff，并使用 0、1、2 作为 VERIFIED、CONCERNS、BLOCKED 的 CI 退出码。
- 支持从多种规格来源启动，包括 PRD、OpenAPI/JSON/YAML、GitHub Issue、Jira 和 GitLab/Azure DevOps issue。
- 既支持新项目构建，也提供带 archaeology、stabilize、isolate、modernize、validate 阶段的旧系统修复流程。
- 提供 Claude Code、Cline、Codex、Aider、opencode 的 provider 路径，以及本地 MCP server、Docker Compose 输出和本地仪表盘。
- Claude Code 是唯一标注为 Tier 1 且端到端验证的 provider；Cline、Codex、Aider 和 opencode 均为实验性且顺序执行。
- 实际构建需要已认证的模型提供商 CLI 或 Anthropic 凭据；`tour` 和离线 demo 只是历史样例回放，不能验证你的项目。
- 凭证未签名时，README 明确承认攻击者若同时重写事实、标题并重算哈希，仍可能通过验证；GPG 签名需自行配置。
- 项目采用 Bash 与 Bun 双运行时，部分命令由 Bun 路由；文档还提示后续大版本可能终止 Bash 运行时，带来迁移风险。
- 许可证信息存在不一致：提供的仓库元数据标为 `NOASSERTION`，README 则声明 BUSL-1.1，并称 2030 年转换为 Apache 2.0。
如何安装或部署这个 Agent？
快速查看离线示例：npx loki-mode tour。推荐全局安装：bun install -g loki-mode；随后运行 loki doctor 检查环境。常规运行需要 Python 3.10+、Git 2.x、curl，以及已安装并认证的 provider CLI；README 将 Claude Code 列为 Tier 1。也可使用内置 Claude Agent SDK：设置 ANTHROPIC_API_KEY=sk-...，并执行 LOKI_SDK_MODE=full loki start prd.md，此路径要求 Bun 在 PATH 中。
如何使用这个 Agent？
首次可执行 loki quickstart，按提示完成环境检查、输入想法、选择模板并审阅计划。脚本化流程可用：loki init my-app --template simple-todo-app，然后 cd my-app && loki start prd.md。运行完成后用 loki proof list 找到凭证，并用 loki proof verify <id> 重新计算哈希和 diff；对现有分支可运行 loki verify。若需要本地仪表盘与预览，使用 loki dashboard 或 loki preview。
这个 Agent 与同类方案有什么区别？
README 将 Loki Mode 与 bolt.new、Replit 和 Lovable 对比，主张其具备自托管、自带密钥、多 provider 故障转移、8 个质量门和盲审。该比较仅针对表中列出的产品，README 也明确表示并未覆盖整个市场。