@agent_forge/forge-darwin-x64 1.75.0 → 1.76.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/README.md +4 -2
- package/bin/forge +0 -0
- package/package.json +1 -1
package/bin/README.md
CHANGED
|
@@ -160,6 +160,8 @@ Forge 退出码三态(`BLOCKED` 硬阻断 / `ADVISORY` 软信号 / 无前缀
|
|
|
160
160
|
forge task start --ref feat/add-login --branch --accept "go test -v ./... :: PASS" # 创建任务+分支+登记验收标准(--accept 可重复;Expected 是输出子串匹配;go test 带 Expected 或 contains/not-contains 断言忘加 -v 时 start 自动补——无 -v 无 PASS 行永不匹配)
|
|
161
161
|
forge task start --ref feat/login --worktree [--base main] [--wt-dir <父目录>] # 在 repo 树外为此任务创建独立 worktree+分支+绑定(多任务并发隔离形态,multi-task-concurrency L4;<repo 父目录>/<repo 名>-wt/<分支> 默认)
|
|
162
162
|
forge task start --ref feat/add-login --scope "internal/auth/*.go" # 声明计划改动白名单(规划前置→可度量契约,advisory 检测 scope-drift)
|
|
163
|
+
forge task start --ref feat/add-login --tier mini # 方案档位:none 直接改 / mini 小方案 / full 完整方案;与硬触发器(迁移/schema/接口契约/鉴权/依赖/跨模块)推导档位取较高者,下调须 --tier-reason 写明理由(advisory)
|
|
164
|
+
# 规则表可在 protocol.yml 的 design_tiers 段覆盖:rules(按 name 追加或替换内置规则,tier 取 mini/full,paths 支持 seg:<目录名> / 含 / 的路径 glob 或目录前缀 / 文件名 glob)、standard_changes(追加不触发档位的例行改动)、replace_defaults(弃用内置规则与内置例行改动)
|
|
163
165
|
forge task start --ref feat/frontend --assignee kimi --role frontend --depends-on feat/api # 创建即分派给 kimi(offered),声明上游依赖 feat/api(DAG 环检测;task-verify/task-complete 在 feat/api 交付前阻断)
|
|
164
166
|
forge task start --ref feat/hotfix --assignee kimi --ttl 24h # per-task TTL 覆盖全局 7d 僵尸窗口:短时效分派 24h 无活动即标僵尸(offered/claimed/input-required 通用;0=用全局默认)
|
|
165
167
|
# AI 自动完成工作...
|
|
@@ -297,7 +299,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
297
299
|
| `forge task wild "<说明>"` | 野外动作申报:任务管道外的显式留痕出口(比静默绕过诚实、比强制建任务轻)。记会话/分支/HEAD/是否已有任务到 `wild/declarations.jsonl`,累计计数供审计回溯(vNext INV-1 的合法出口之一) |
|
|
298
300
|
| `forge task status` | 查看当前任务门禁状态(含已登记产物链产物与漂移/审批态) |
|
|
299
301
|
| `forge task list --plan-conversion` | plan-first advisory 转化率报告(先测量再翻转):已发/发后已补方案/发后仍无方案/未发自带方案四计数 + 转化率——叙事 stage 是否升档由数据决定而非直觉 |
|
|
300
|
-
| `forge task artifact --set <stage> --file <path> \| --stdin \| --list [--json] \| --verify \| --approve <stage> --by <人> \| --extract` | 产物链操作(L6 契约层,docs/design/artifact-chain-workflow.md
|
|
302
|
+
| `forge task artifact --set <stage> --file <path> \| --stdin \| --list [--json] \| --verify \| --approve <stage> --by <人> [--checked <项>] \| --extract \| --check [--file <path>]` | 产物链操作(L6 契约层,docs/design/artifact-chain-workflow.md):登记阶段产物(哈希引用,漂移探测;登记 design 产物时其「触点」一节自动写入 PlanScope(手工 `--scope` / `task scope add` 优先),实改超出即报「方案外改动」)/ 查看链态 / 漂移校验(采用需求 ID 的任务附需求覆盖表:已验证/未验证/孤儿)/ 人工审批(human 档经 --by 归因到人、签内容哈希,内容再改即作废;批前打印一屏审批摘要——TL;DR、高危步骤、Open Questions、自上次批准的变化;`--checked` 可重复,记录本次审了什么)/ 从产物提取验收标准(`accept: <cmd> :: <expected>` 行与 \`\`\`accept 围栏编译成验收门禁——产物成为硬门禁的源码;提取的标准盖考卷层级 spec-extract;`accept[REQ-3]:` 前缀或行尾 `#REQ-3` 声明该条验证的需求 ID,两种写法并存取并集)/ 方案事实核查 `--check`(方案中的路径、`file:line`、Go 符号、Go 模块是否真实存在;`new:` 行豁免;advisory)。链与档位(advisory\|rubric\|human\|hard,HARD 只守事实)由 `<DataDir>/schemas/schema.yaml` 声明(缺省默认链 proposal→spec→design→plan 全 advisory 零阻断);`task start --artifact "<stage>=<path>"` 开工即登记并就地提取验收;complete 前漂移 pre-flight:hard/human 档漂移阻断、advisory/rubric 留痕、漂移一律作废审批;逃生(落审计)`FORGE_ARTIFACT_CHAIN=disable` 或 `forge task override --artifact-chain disable` |
|
|
301
303
|
| `forge task chain-init [--force]` | 一键接线产物链执法(oracle-pipeline L0):写默认链 schema 且 spec 档升 human——spec 里的考卷围栏(accept: 行/```accept 块)从此需 forge task artifact --approve spec --by <审批人> 签字才算定稿,内容再改即作废(业务正确性的签字入口);已存在 schema 须 --force 显式覆盖;不依赖活跃任务 |
|
|
302
304
|
| `forge task mine [--agent <agent>] [--role <role>] [--all-projects] [--blocked] [--json]` | 列出分派给当前/指定 agent 的任务(`--all-projects` 全仓扫描按项目分组;`--blocked` 仅被依赖阻塞的,标注卡在哪环 [status, gate 进度 passed/total]) |
|
|
303
305
|
| `forge task gate <gate-id>` | 验证单道任务门禁 |
|
|
@@ -420,7 +422,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
420
422
|
| `forge skills install` | 分发 skill 到全局/项目目标目录(link/copy) |
|
|
421
423
|
| `forge skills list` | 列出 canonical skill 库中的 skill |
|
|
422
424
|
| `forge skills audit` | 21 条安全规则审查(prompt 注入/数据外发/危险代码/供应链执行向量;任一 CRITICAL finding 即阻断 install/--gate) |
|
|
423
|
-
| `forge skills drift-check` | 检测分发分叉(dry-run
|
|
425
|
+
| `forge skills drift-check` | 检测分发分叉(dry-run,不写);另报其他已安装 Claude Code 插件里与核心同名的 skill(plugin-shadow;forge 插件提示升级去重,第三方插件提示停用其一) |
|
|
424
426
|
| `forge skills validate` | R1-R18 规范校验 |
|
|
425
427
|
| `forge skills adapters` | 部署 skill-routing adapter(pi/claude/cursor/routes.json) |
|
|
426
428
|
| `forge skills usage` | 使用度量分析(热门 skill + undertrigger 候选) |
|
package/bin/forge
CHANGED
|
Binary file
|
package/package.json
CHANGED