@agent_forge/forge 1.3.2 → 1.4.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 +7 -34
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,9 +6,8 @@ Forge 在 AI 编码过程中自动插入结构化质量门禁——从任务创
|
|
|
6
6
|
|
|
7
7
|
## 核心功能
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
- **实时 Hook 拦截** — 8 个内置 Hook，在 AI 写代码的同时自动检查质量、防止绕过
|
|
9
|
+
- **任务级门禁** — 每个开发任务走 3 道门禁：实现 → 验证 → 完成
|
|
10
|
+
- **实时 Hook 拦截** — 多个内置 Hook，在 AI 写代码的同时自动检查质量、防止绕过
|
|
12
11
|
- **安全纵深防御** — 三层防御架构：工具拦截 → 文件监控 → 自身保护
|
|
13
12
|
- **跨项目经验库** — 提取项目踩坑经验，在新项目中自动提示
|
|
14
13
|
- **质量评分** — 每个任务完成后自动评分，量化 AI 编码质量
|
|
@@ -30,23 +29,13 @@ forge init
|
|
|
30
29
|
```
|
|
31
30
|
|
|
32
31
|
初始化后 Forge 会创建：
|
|
33
|
-
- `.forge/` —
|
|
32
|
+
- `.forge/` — Hook 脚本、任务状态、协议配置
|
|
34
33
|
- `.claude/settings.local.json` — Hook 集成配置
|
|
35
34
|
- `.claude/CLAUDE.md` — 质量协议引用
|
|
36
|
-
- `.claude/skills/` —
|
|
35
|
+
- `.claude/skills/` — 质量协议 Skill
|
|
37
36
|
|
|
38
37
|
## 工作流程
|
|
39
38
|
|
|
40
|
-
### 项目级管道
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
forge init → 自动检测项目规模 → 生成门禁管道
|
|
44
|
-
|
|
45
|
-
gate-1-prd (需求定义) → gate-3-plan (实现计划) → gate-4-implement (代码实现) → gate-5-test (测试验证) → gate-6-acceptance (项目验收)
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
`forge init` 根据项目规模自动选择门禁数量（small / medium / large），`forge status` 查看所有启用的 gate。
|
|
49
|
-
|
|
50
39
|
### 任务级门禁
|
|
51
40
|
|
|
52
41
|
每个开发任务自动走 3 道门禁：
|
|
@@ -76,6 +65,7 @@ Forge 通过 Claude Code 的 Hook 机制实现实时质量检查：
|
|
|
76
65
|
| **tool-track** | Read 后 | 静默记录 Read 调用到 toollog，供 task-verify 的 read-before-edit 门禁判断（agent 是否先读代码再改） |
|
|
77
66
|
| **task-verify** | 会话结束 | advisory：任务门禁/主分支保护/mandatory review 提醒到 stderr+checklog（不阻塞会话结束） |
|
|
78
67
|
| **skill-scan** | 会话开始 | advisory：扫描 ~/.claude/skills 安全性（forge audit 19 规则），补 install 门控缺口（手动 clone/junction/git pull 进入的 skill），全局 hook 不依赖 forge project |
|
|
68
|
+
| **task-resume** | 会话开始 | advisory：自动注入活跃任务的接续上下文（目标/计划/决策/阻塞/门禁进度/git 已改未提交）+ 锚定当前 session——接手方冷启动即知任务在哪一步；无活跃任务静默；项目级 hook |
|
|
79
69
|
|
|
80
70
|
### 安全架构
|
|
81
71
|
|
|
@@ -101,12 +91,9 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
101
91
|
|
|
102
92
|
| 命令 | 说明 |
|
|
103
93
|
|------|------|
|
|
104
|
-
| `forge init
|
|
105
|
-
| `forge status [--json]` |
|
|
106
|
-
| `forge gate <gate-id>` | 验证指定门禁 |
|
|
107
|
-
| `forge validate` | 检查 pipeline.yml 配置 |
|
|
94
|
+
| `forge init` | 初始化项目（生成 `.forge/` 资产、Hook、质量协议 Skill；旧的 `--mode` 标志已废弃为 no-op） |
|
|
95
|
+
| `forge status [--json]` | 查看项目状态（任务管道 + 质量信号） |
|
|
108
96
|
| `forge verify` | 项目完整性检查 + 回归测试 |
|
|
109
|
-
| `forge snapshot` | 检测项目开发阶段 |
|
|
110
97
|
| `forge update` | 自更新到最新版本 |
|
|
111
98
|
|
|
112
99
|
### 任务管理
|
|
@@ -139,20 +126,6 @@ npm install -g @agent_forge/forge
|
|
|
139
126
|
# 支持平台：macOS (x86_64/ARM64)、Linux (x86_64/ARM64)、Windows (x86_64)
|
|
140
127
|
```
|
|
141
128
|
|
|
142
|
-
## 项目门禁管道
|
|
143
|
-
|
|
144
|
-
| Gate ID | 名称 | small | medium | large |
|
|
145
|
-
|---------|------|:-----:|:------:|:-----:|
|
|
146
|
-
| gate-1-prd | 需求定义 | ✓ | ✓ | ✓ |
|
|
147
|
-
| gate-3-plan | 实现计划 | ✓ | ✓ | ✓ |
|
|
148
|
-
| gate-4-implement | 代码实现 | | ✓ | ✓ |
|
|
149
|
-
| gate-5-test | 测试验证 | | ✓ | ✓ |
|
|
150
|
-
| gate-6-acceptance | 项目验收 | | ✓ | ✓ |
|
|
151
|
-
| gate-8-release | 发布 | | | ✓ |
|
|
152
|
-
| gate-0-research | 立项调研 | | | ✓ |
|
|
153
|
-
| gate-2-design | 技术方案 | | | ✓ |
|
|
154
|
-
| gate-7-archive | 经验归档 | | | ✓ |
|
|
155
|
-
|
|
156
129
|
## License
|
|
157
130
|
|
|
158
131
|
Apache-2.0
|