@zythegit/agentforge 0.2.3-rc.3 → 0.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/README.md +18 -3
- package/dist/aforge.js +325 -275
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -56,13 +56,26 @@ aforge status # SoT 概览：scope、各 target 落点与技能调
|
|
|
56
56
|
aforge doctor # 体检：配置合法性、投影一致性、环境问题
|
|
57
57
|
aforge sync --dry-run # 只看会写哪些文件，不落盘
|
|
58
58
|
aforge learn # 记一条 learning（不投影，promote 后才进规则）
|
|
59
|
-
aforge learn --file - # 从 stdin 读正文（管道 / agent 调用；非交互终端必须走这条）
|
|
60
59
|
aforge learn --file notes.md # 从文件读正文
|
|
61
60
|
aforge skill add <name> # 装技能进 SoT 并登记，sync 后投影到四家
|
|
62
61
|
aforge mcp add # 登记 MCP 服务器，sync 时翻译成各 Agent 的原生配置
|
|
63
62
|
```
|
|
64
63
|
|
|
65
|
-
|
|
64
|
+
### 把 learning 从管道喂进去
|
|
65
|
+
|
|
66
|
+
`aforge learn` 无参数时在交互终端弹粘贴框；**非交互场景（agent 调用、脚本、CI 之外的自动化）走 `--file`**：
|
|
67
|
+
|
|
68
|
+
```powershell
|
|
69
|
+
echo "Use pnpm, never npm, in this repo." | aforge learn --file - # 管道读正文
|
|
70
|
+
aforge learn --file - < notes.md # 重定向读正文
|
|
71
|
+
aforge learn --file notes.md # 直接给路径（多行正文更省事）
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
`--file -` 读的是**要沉淀的条目正文**，一次调用记一条。它必须有管道或重定向——在交互终端裸敲会直接报错并提示这三种形态，不会挂在那里等输入。
|
|
75
|
+
|
|
76
|
+
让 agent 自己沉淀经验：把 `learning.auto_capture` 设为 `prompt`（投影正文里多一段协议，告诉 agent 什么时候该调 `aforge learn --file -`）或 `hook`（codex 侧会话钩子注入）。没有钩子落点的三家可以手工挂载同一份协议，写法见 [learning](docs/learning.md#手工挂载把协议塞进没有落点的三家)。
|
|
77
|
+
|
|
78
|
+
**`aforge learn --print-protocol` 的输出不能喂回 `aforge learn`。** 它打印的是**给 agent 看的协议**，不是条目正文；管道进去只会把协议本身存成一条 learning。
|
|
66
79
|
|
|
67
80
|
任何子命令都可加 `--json` 拿机器可读输出（路径一律绝对路径）。完整 14 个命令、参数与退出码见 [命令速查](docs/commands.md)。
|
|
68
81
|
|
|
@@ -105,7 +118,9 @@ aforge mcp add # 登记 MCP 服务器，sync 时翻译成各 Agent
|
|
|
105
118
|
- [命令速查与约定](docs/commands.md)——14 个命令、`--json` 契约、环境变量、退出码
|
|
106
119
|
- [profile.yaml 配置参考](docs/profile.md)——全字段类型/默认值、两层合并语义、投影开关
|
|
107
120
|
- [habits.yaml 配置参考](docs/habits.md)——运行时/工具/AI 习惯声明，以及哪些字段真正进投影正文
|
|
108
|
-
- [规则正文装配](docs/rules.md)
|
|
121
|
+
- [规则正文装配](docs/rules.md)——四层顺序，以及 `custom/` 与 `templates/` 怎么选
|
|
122
|
+
- [custom/ 逐字规则](docs/custom-rules.md)——收录规则、什么时候该用它
|
|
123
|
+
- [templates/ 模板](docs/templates.md)——登记与查找优先级、三个内置模板、可用变量、引擎约束
|
|
109
124
|
- [安装与构建](docs/install.md)——三种装法、双轨构建、开发命令
|
|
110
125
|
- [技能](docs/skills.md)——登记来源、安装、投影落点与调用前缀，以及 `expose_as_command` 命令薄壳（命名空间、`$1..$9`）
|
|
111
126
|
- [MCP](docs/mcp.md)——一份声明翻译成四家的原生配置
|