@ codedology/ code- forge (帮助)
一个CLI和Agent Skill用于跨型,平行,有证据特征的提供.
最近:0.21.0 - 见 变动情况
问题
一个特工可以快速地写出代码,但你仍然需要决定构建什么以及如何检查. 长的任务会失去上下文,并行编辑会碰撞,而绿色测试会错过预定的行为. 代码-forge将工作分割成自有块,给每个更改一个新审查,并记录证明. 你批准计划 并控制预算,许可, 并着陆结果.
安装
需要节点.js \\\ 22和git。 用 CLI 安装 CLI npm install -g @codedology/code-forge。 。 。 .
macOS: 工作树默认为 .noindex 文件夹,所以 Spotlight 不索引它们.
范围 npm 名称只用于安装; 命令是 code-forge。 。 。 .
未瞄准的 npm 包 code-forge 是一个无关的工具.
运行设置向导 :
code-forge init
按 Enter 为工具、 工具、 工具、 提供者、 多模式审查、 密钥和引擎等默认设置.
向导检测出门和证明设置,标记空白,并允许您使用、自定义或推迟
他们。 写着 .code-forge.yml 并将技能与检测到的绳子联系起来。 重新运行它
保留它已经写的。 对于没有System-1(Jev)密钥的第一次尝试:
code-forge init --no-interaction --no-jev
准备时使用 --jev-ref <1Password item ID|link|op://vault/item/field> 或者说
--jev-env MY_JEV_KEY 改为 --no-jev。见 设置细节。 。 。 .
什么样的船
- 这个
code-forgeCLI 和一个只讲道的人 特工技能,带有支持 参考文献。模型标识、努力、命令、阈值和路径来自 配置或CLI. - 一个JSON Schema为
.code-forge.yml及其产生的 配置参考。 。 。 . - 一个 示例存储器 (单位:千美元) 块形地图。 。 。 .
5分钟快速启动
设置后, 检查配置、 选定模型和安装的链接 :
code-forge validate
code-forge resolve L1
code-forge doctor --quick
code-forge list
code-forge keys list
code-forge models
code-forge --help
code-forge version
resolve 打印一个级别的提供者、模型、努力、倒计时和CLI. doctor --quick
检查配置、链接和关键解析度; keys list 打印源和过期, 永远不值,
警告者,临终不到一小时.
写一个简短的描述 变化和如何你知道它的工作。 在你的经纪人,请引用
/code-forge full path/to/brief.md它计划,硬化, 让你批准计划,然后代码.
使用 /code-forge plan|harden|code <file> 一次一个阶段.
设置每个运行 budget.usd 在开始付费会话之前:一次警告为80%,没有一次警告为100%.
这个 初试辅导 - 通过完整的分娩;
简短模式 包括一个没有计划的小任务.
仅审查
对于您已经写的代码, 请在仓库中运行 :
code-forge review
它对照与默认分支合并基数审查分支,或未承诺的工作
默认分支,使用新的闭页会话。 它没有计划员 编码员 也没有证据.
缩小 --files <paths…>选择 --base <ref>解释 --intent "<text>",或使用
--json。退出 0 是指所有批准或无任何审查; 1 是指发现、停止或无法审查
审查; 2 表示使用。 见 仅审查的细节。 。 。 .
如何运作
plan -> code -> review -> proof -> land
^ | |
| +<--fix-+
+-- human approval after hardening
技术检查和强化计划 在你批准之前。 编译者在区块中工作 拥有文件和接受条款; 独立的块可以平行运行。 一个工人跑来跑去 编辑器沙盒外的审阅会 固定回合被限制;未解决的工作停止. 检验和红色-绿色证明证明,在关闭之前,更改符合其接受条款. 您控制了最后的合并和发布权限; 代码器无法按下或打开 PR 草稿 默认。 见 工作流程 财务报告和审定财务报表 概念。 。 。 .
密钥命令
| 命令 | 用它来 |
|---|---|
code-forge init | 配置工程并安装技能 |
code-forge doctor --quick | 检查配置、链接和密钥 |
code-forge review | 没有编码程序审查已有更改 |
code-forge run start|status|reload|end | 管理运行并检查其开支 |
code-forge block open|close|stop | 跟踪自有工作并强制执行其验收门 |
code-forge review-file | 进行文件审查或等待票单 |
code-forge proof tier|red-green | 选择证明力并证明测试在修复前失败 |
code-forge gates detect|run | 发现并运行项目检查 |
code-forge keys list|set|test|remove | 不打印机密而管理密钥引用 |
code-forge report | 检查记录的结果和费用 |
code-forge outcome seal|check | 在呼叫者使用前封住一个专家结果并检查其文件 |
code-forge pipeline status|next | 见专家步骤和下一个准备步骤 |
code-forge logs | 检查本地错误; logs report 预览公有问题 |
code-forge upgrade | 更新软件包后刷新已安装的技能副本 |
code-forge --help | 列出每个动词; 每个动词在不良参数上打印自己的用法 |
技术通常叫 run, (中文(简体) ), block, (中文(简体) ), worker, (中文(简体) ), spawn, (中文(简体) ), s2, (中文(简体) ), author, (中文(简体) ), facts,以及
review-file 给你的 见 工作流程 这些低级业务.
升级,运行 npm install -g @codedology/code-forge@latest,则 code-forge upgrade 用于版本摘要和发布注释; 添加 --plain 只是安装线.
配置参考
计划/代码-forge.schema.json 是真理的来源.
参考文献列出了每个密钥,类型和默认,包括预算,升级,编码器地板,
审查风险、多模式、货币和超时设置.
review.routes 向另一个模型发送大文件,并带有自己的超时和二级.
见 路由和倒置示例 上面的长文审查者
400行和倒数列表 {provider, model} 对象(可选) effort永远不要弦.
block open --kind code|docs|contract 覆盖从文件名中推断出来的类型.
重现引用 node scripts/gen-config-doc.mjs; 添加 --check 检查它.
支助代理人
使用克洛德代码(Claude Code), Codex, 或Grok作为代理吊带,或Solo作为执行引擎. 双子座克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. 见 代理支持和限制 适用于适配器和已退化模式. 封闭图书角色限制说明如下.
安保模式
审查和大门行由HMAC签署: signer: same-user boundary only进程为
您可以读取签名密钥; 无法针对此进程进行防御. doctor 说明限制.
提供方和Jev键只在工人或管弦乐手中解决:环境 → OS键链 →
1Password (默认时间为8小时,最多24小时) – 设置快取. 密钥永远无法到达编码器;
键命令打印无值,输出被编辑。 提供者拒绝列表会限制编码器动作.
评论员、法官、系统2和计划作者只看到他们的包:克劳德没有工具
Grok拒绝所有工具 Codex总是有一个外壳,所以这些角色默认被拒绝;
review.allow_open_book_codex: true 选择带有警告的风险.
错误会停留在本地的被清理的日志中 . logs report 清理两次,检查密钥,预览
发出,只发出你的同意; CODE_FORGE_NO_ERROR_LOG=1 禁用日志 .
证明使用单位/地貌测试和红地-绿色,没有突变测试或手突变.
见 安全细节 财务报告和审定财务报表 隐私。 。 。 .
链接
发展
一揽子船舶普通无害环境管理 .mjs 没有构建步骤的文件。 在一次离职中,运行 npm install, (中文(简体) ),
npm test,以及 npm run typecheck。在释放前检查生成的配置引用.
记录更改为 npm run changelog -- <type> "<text>"; 记录固定错误报告
npm run known-fix -- add <fp> <version> "<summary>"。 。 。 . npm run release -- <bump> [--dry-run]
凸起版本,发布 ChangeGELOG, 更新可选的最新行, 检查, 承诺,以及
标签。 发布方式 npm publish,然后按下标记;CI创建了 GitHub 发布.
见 释放。 。 。 .