LoopForge Local 可在现有编程助手中安装项目级工作流。Codex 用户在项目根目录运行 loopforge-cli 的 install codex,再用 status 和 doctor 检查安装,重开项目会话后通过 devflow-codex 技能进入流程。
确认当前项目和本地运行环境
先把运行环境配齐:node.js 20+、python 3.8+、git,还有正常可用的codex。安装器会直接写入项目配置,第一次上手建议在空的git目录里操作练手。下面我们统一用npm已发布的0.2.2版本,保证和本次实测的输出结果对应。
node --version python3 --version git --version mkdir loopforge-local-demo cd loopforge-local-demo git init npx -y loopforge-cli@0.2.2 plan codex
plan 命令只会读取需要安装的资产,不会改动当前项目内容。确认当前所在目录正确之后再执行正式安装。如果是已有同名工作流的真实项目,先查看配置差异和原有安装状态,再决定冲突的处理方案。
安装 Codex Classic 并检查写入结果
npx -y loopforge-cli@0.2.2 install codex npx -y loopforge-cli@0.2.2 status codex
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

本次在隔离空目录里安装的输出显示 written=52。status 返回 classic/codex,同时显示 files=52、changed=0、missing=0,说明安装器托管的文件全部完整,没有发生改动。你本地现有的安装状态不同,统计出的数量和变更数据也可能不一样。
npx -y loopforge-cli@0.2.2 doctor find .agents/skills -name SKILL.md -print ls .codex python3 -m json.tool .devflow/install-state.json

在 Codex 会话里启动首个小任务
从同一个项目目录重启 Codex,它会自动识别到 .agents/skills/devflow-codex/SKILL.md 文件。直接输入指令:“$devflow-codex start 为 README 增加一段本地运行说明,只修改文档并检查命令是否与项目一致”,这是直接发给 Agent 的会话指令。
先确认它读取的是当前仓库,再检查它对需求范围的理解没有偏差。任务开始运行后,所有过程证据会按 task_slug 自动写入 artifacts 目录。微小任务可以直接走精简路径,中大型任务再调用设计、实现、审查和测试等全阶段。
status 正常但会话没有发现技能时怎么查
先核对 Codex 当前的工作目录和你执行安装的目录完全一致,再检查 .agents/skills 下的技能入口文件,以及 .codex 目录内的工作流文件。所有状态都正常的话重新打开一次项目会话,直接用技能名称显式触发就行。Classic 和 Portable 两个版本用的是不同入口,当前教程安装的是 Classic 版本。
如果 npm 报 ETARGET 错误,先执行 npm view loopforge-cli version 查询,确认你填写的版本已经公开发布。平台发行版号、源码包文件里的开发版本和 npm 可用版本要分别核对清楚。


















