Skip to content

Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

2.5 KB
Raw Blame

LoopForge Local architecture

local/ 包含两个明确分离的工作流实现和一个统一安装控制面。下述源码路径均相对于 local/,开发命令也在该目录内执行。平台架构见总体架构。

Classic Edition

.codebuddy/ 是参考行为和主要人工维护面;.codex/ 是已有 Codex 原生适配; .cursor/ 与 .claude/ 由 build-classic-hosts.py 生成。四个目录都是完整宿主包, 不读取 skills/devflow 作为运行时来源。

Portable Edition

skills/ 提供独立的新 DevFlow 状态机、模板、规则、测试和 adapter, 支持 CodeBuddy、Codex、Cursor、Claude Code、Pi、DeepSeek Harness 和 Hermes Agent(Pi 只有声明型 adapter, isolated 模式依赖公开扩展 npm:pi-subagents;DSH 使用内置 subagent 工具;Hermes 使用 delegate_task)。脚本只依赖 Python 3.8+ 标准库;具体 Agent 调度能力由宿主提供。

skills/manifest.json 是跨宿主 Skill 集合清单。skills/ 是这一层的唯一 事实源。逻辑角色、产物、规则和宿主能力分别由 对应 manifest 管理;Cursor 与 Claude Code 共用的 Portable 执行器正文只保留一份。 Portable 安装到目标项目时才生成 .cursor/.claude/.agents/.codebuddy 内容,不能 反向覆盖仓库内的 Classic 包。

安装到其他项目时优先创建相对软链接。不能使用软链接的平台可加 --copy-skills;安装器会记录自己管理的副本,之后只有显式 --refresh-managed 才覆盖这些副本,不碰项目自有 Skill。

统一安装控制面

DevFlow CLI 负责 install、status、update、uninstall 和 doctor。四个 target 保持薄层,安装核心统一处理计划、冲突检查、状态记录和用户文件保护。默认 edition 是 Classic;loopforge install <host> 安装完整宿主包,Portable 通过 loopforge skills install <host> 安装。安装器不改变两套工作流的内部状态机。

可选工具与私有扩展

tools/ 存放不进入 Classic/Portable 安装包和 loopforge-cli npm 包的配套工具。 当前 tools/tcmcp 是腾讯云只读 MCP Initializr,由克隆仓库或 GHCR 镜像单独运行。

CI/CD、工单、企业代码托管、知识库、聊天通知,以及未开源的云运维能力,应保存在部署方的 私有仓库,通过本地配置或受控安装叠加。不要把 CAM 策略、内网域名或运维 MCP 写进 Classic/Portable 工作流模板。