@agent_forge/forge 1.22.1 → 1.24.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/README.md +12 -9
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ Forge 在 AI 编码过程中自动插入结构化质量门禁——从任务创
|
|
|
19
19
|
# 安装
|
|
20
20
|
npm install -g @agent_forge/forge
|
|
21
21
|
|
|
22
|
-
#
|
|
22
|
+
# 在项目目录初始化（默认零项目写入）
|
|
23
23
|
cd your-project
|
|
24
24
|
forge init
|
|
25
25
|
|
|
@@ -27,11 +27,14 @@ forge init
|
|
|
27
27
|
# AI 会自动读取 Forge 生成的 Skill 并驱动门禁流程
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
-
|
|
30
|
+
`forge init` 不在项目目录写任何文件，全部资产落在用户级：
|
|
31
|
+
- `~/.forge/projects.json` — 全局项目注册表
|
|
32
|
+
- `~/.forge/projects/<key>/` — protocol.yml + runtime state（任务状态/hook 参考副本）
|
|
33
|
+
- `~/.claude/settings.json` — Claude Code hooks（plugin 已装则由 plugin 接管）
|
|
34
|
+
- `~/.claude/CLAUDE.md`、`~/.codex/AGENTS.md` — 质量协议（备份+追加，`forge uninstall --restore` 可回滚）
|
|
35
|
+
- `~/.claude/skills/forge-quality/` — 质量协议 Skill
|
|
36
|
+
|
|
37
|
+
团队要 git 共享协议用 `forge init --project`（团队模式，指令资产写项目目录）。
|
|
35
38
|
|
|
36
39
|
## 工作流程
|
|
37
40
|
|
|
@@ -56,7 +59,7 @@ Forge 通过 Claude Code 的 Hook 机制实现实时质量检查：
|
|
|
56
59
|
|
|
57
60
|
| Hook | 触发时机 | 功能 |
|
|
58
61
|
|------|----------|------|
|
|
59
|
-
| **task-guard** | Write/Edit 前 | 无活跃任务时 WARN（仅 `.forge
|
|
62
|
+
| **task-guard** | Write/Edit 前 | 无活跃任务时 WARN（仅 `.forge/*`/`.claude/settings*` 自保护 FAIL——此类项目级文件只在团队模式/老项目存在），保护 Forge 配置不被篡改 |
|
|
60
63
|
| **assertion-check** | Write/Edit 前 | 检测断言弱化（t.Fatal → t.Log、assert! 被删除等），advisory 提醒不阻塞（agent 自检） |
|
|
61
64
|
| **bash-guard** | Bash 前 | 检测命令中的写文件模式（writeFile、cat >、sed -i 等），无任务时 WARN（源码随后被 file-sentinel 隔离） |
|
|
62
65
|
| **auto-compile** | Write/Edit 后 | advisory 提醒用对应技术栈编译命令自检（go build / cargo check / mvn / tsc 等），不强制编译 |
|
|
@@ -72,7 +75,7 @@ Forge 通过 Claude Code 的 Hook 机制实现实时质量检查：
|
|
|
72
75
|
|
|
73
76
|
```
|
|
74
77
|
Layer 1: PreToolUse 快速拦截
|
|
75
|
-
├─ task-guard: Write/Edit → 检查任务状态 +
|
|
78
|
+
├─ task-guard: Write/Edit → 检查任务状态 + 自保护（forge 配置层）
|
|
76
79
|
└─ bash-guard: Bash → 检测写文件模式
|
|
77
80
|
|
|
78
81
|
Layer 2: PostToolUse 文件监控
|
|
@@ -90,7 +93,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
90
93
|
|
|
91
94
|
| 命令 | 说明 |
|
|
92
95
|
|------|------|
|
|
93
|
-
| `forge init` |
|
|
96
|
+
| `forge init` | 初始化项目（默认零项目写入：登记全局注册表，hooks/指令/skill 全在用户级；`--project` 团队模式把指令资产写项目目录供 git 共享；旧的 `--mode` 标志已废弃为 no-op） |
|
|
94
97
|
| `forge status [--json]` | 查看项目状态（任务管道 + 质量信号） |
|
|
95
98
|
| `forge verify` | 项目完整性检查 + 回归测试 |
|
|
96
99
|
| `forge update` | 自更新到最新版本 |
|
package/package.json
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent_forge/forge",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.24.0",
|
|
4
4
|
"description": "AI 开发质量门禁引擎 — 结构化门禁管道，在 AI 生成的代码进入仓库前进行质量锻造",
|
|
5
5
|
"bin": {
|
|
6
6
|
"forge": "run.js"
|
|
7
7
|
},
|
|
8
8
|
"optionalDependencies": {
|
|
9
|
-
"@agent_forge/forge-darwin-arm64": "1.
|
|
10
|
-
"@agent_forge/forge-darwin-x64": "1.
|
|
11
|
-
"@agent_forge/forge-linux-arm64": "1.
|
|
12
|
-
"@agent_forge/forge-linux-x64": "1.
|
|
13
|
-
"@agent_forge/forge-win32-x64": "1.
|
|
9
|
+
"@agent_forge/forge-darwin-arm64": "1.24.0",
|
|
10
|
+
"@agent_forge/forge-darwin-x64": "1.24.0",
|
|
11
|
+
"@agent_forge/forge-linux-arm64": "1.24.0",
|
|
12
|
+
"@agent_forge/forge-linux-x64": "1.24.0",
|
|
13
|
+
"@agent_forge/forge-win32-x64": "1.24.0"
|
|
14
14
|
},
|
|
15
15
|
"files": [
|
|
16
16
|
"run.js",
|