@agent_forge/forge-linux-x64 2.1.3 → 2.3.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 +18 -10
- package/bin/forge +0 -0
- package/package.json +1 -1
package/bin/README.md
CHANGED
|
@@ -89,16 +89,18 @@ Forge 是 deterministic 的——范围是 "deterministic where code can verify"
|
|
|
89
89
|
cd your-project
|
|
90
90
|
forge init # 在仓库里声明契约:只写仓库内产物
|
|
91
91
|
git add -A && git commit -m "chore: forge init" # 让 next 看到干净工作区
|
|
92
|
-
|
|
93
|
-
#
|
|
92
|
+
# 有了新需求就直接开工(见场景 A/B);不必先跑 forge next
|
|
93
|
+
# forge next 只回答「接着做手上这件事该怎么走」——它在有 bug/改动时给还原命令,
|
|
94
|
+
# 无任务且干净时给下一条任务入口;陈旧的 ready change 只出现在 stale_changes 里,
|
|
95
|
+
# 不会把你拖回三天没动的旧活
|
|
94
96
|
```
|
|
95
97
|
|
|
96
98
|
**场景 A:小修——任务是一等入口,直接开工**(change 可以事后补)
|
|
97
99
|
|
|
98
100
|
```bash
|
|
99
|
-
forge task start --ref feat/fix-typo --branch --title "修正文案"
|
|
101
|
+
forge task start --ref feat/fix-typo --branch --title "修正文案" --agent <实现者 id>
|
|
100
102
|
# 做完依次跑:task gate task-implement → task verify-acceptance
|
|
101
|
-
# → review pass --reviewer
|
|
103
|
+
# → review pass --reviewer <该任务绑定的评审者 id> → task gate task-complete → task complete
|
|
102
104
|
```
|
|
103
105
|
|
|
104
106
|
**场景 B:想留可评审记录——先立 change,再钉契约开工**
|
|
@@ -110,9 +112,14 @@ forge change new my-feature --title "一句话说清要做什么"
|
|
|
110
112
|
forge change clarify my-feature --by-human --note "只改 A.txt 的文案,不动 B 模块与接口"
|
|
111
113
|
# 补齐 goal.md(三段)/ change.md(改动·影响·验证)/ acceptance.md
|
|
112
114
|
forge change phase my-feature # 每补一份看一次,直到 ready
|
|
113
|
-
forge task start --ref feat/my-feature --branch --change my-feature
|
|
115
|
+
forge task start --ref feat/my-feature --branch --change my-feature --agent <实现者 id> \
|
|
116
|
+
--accept "test -f A.txt" --accept-red "test -f A.txt" # --accept-red:开工时它应当失败
|
|
114
117
|
```
|
|
115
118
|
|
|
119
|
+
两条 2.1 起的新默认:**实现者身份**(`--agent`)让 `review pass` 能拒绝自批;**先失败证明**
|
|
120
|
+
(`--accept-red`)让 `task complete` 能证明判据在实现前确实红过(没有可失败的场景可不登记,
|
|
121
|
+
交付单会如实写「未登记」)。
|
|
122
|
+
|
|
116
123
|
带 `--change` 时那个 change 必须已 `ready`(阶段机只读文件,不写状态);不带
|
|
117
124
|
`--change` 则随时可以开工——change 可以事后补,`forge change verify` 才是它的封口。
|
|
118
125
|
|
|
@@ -322,19 +329,20 @@ rm -rf ~/.forge/skills-backup ~/.forge/.init-suggested
|
|
|
322
329
|
| `forge task artifact …` / `forge task chain-init` | 命令已删除;产物就是 change 里的 `goal.md` / `change.md` / `acceptance.md` |
|
|
323
330
|
| `forge selfcheck` | 该子命令已删除;用 `forge docs lint <文件>` + `forge change check` |
|
|
324
331
|
| `forge eval artifact-drill` | 子命令已删除;用 `scripts/checks/release-smoke.sh <forge 二进制>`(发布冒烟)或 `forge change check` |
|
|
325
|
-
| `forge review pass --note "…"` 刷新基线 |
|
|
332
|
+
| `forge review pass --note "…"` 刷新基线 / 每轮换新 reviewer | 2.1 起改为**评审者复用**:首轮 `--reviewer <id>` 绑定,之后每轮用同一 id(换新 id 会把旧问题丢掉、永远收敛不了);确实要换人用 `--rotate-reviewer --reason "…"` 留痕;上一轮未闭合项用 `--findings <清单>` 承接 |
|
|
326
333
|
| 五份产物(proposal/design/tasks + acceptance + goal) | 三份:`goal.md`(三段)+ `change.md` + `acceptance.md`;`clarify.md` 记人确认,`tasks.md` 可选 |
|
|
327
334
|
|
|
328
|
-
`forge
|
|
335
|
+
`forge integrations` / `forge hook` / `forge freeze` / `forge doctor` 已在 1.85 删除,
|
|
329
336
|
宿主层(用户级 CLAUDE.md / AGENTS.md 注入、hook 执行、插件、skills 分发)整体不存在了;
|
|
330
|
-
升级前如果还留着那些注入,按上一节「从 1.84
|
|
337
|
+
升级前如果还留着那些注入,按上一节「从 1.84 及更早版本升级」清掉。`forge init` 仍然存在,
|
|
338
|
+
但它现在只写仓库内产物(契约 / changes 目录 / AGENTS 托管块 / 已存在的指针文件),不碰用户目录。
|
|
331
339
|
|
|
332
340
|
### 每个老项目要做的
|
|
333
341
|
|
|
334
342
|
```bash
|
|
335
343
|
# 0) 先升级二进制
|
|
336
|
-
npm i -g @agent_forge/forge@2.
|
|
337
|
-
forge version # 应 >= 2.
|
|
344
|
+
npm i -g @agent_forge/forge@2.1.3 --include=optional --registry=https://registry.npmjs.org
|
|
345
|
+
forge version # 应 >= 2.1.3
|
|
338
346
|
|
|
339
347
|
# 1) 仓库里:搬旧 runtime state(.forge/ 里有历史 task/checklog 时)
|
|
340
348
|
cd <your-repo>
|
package/bin/forge
CHANGED
|
Binary file
|
package/package.json
CHANGED