@fanglinwei/agent-fit 0.7.4 → 0.9.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/.codex-plugin/plugin.json +1 -1
- package/README.md +33 -129
- package/VERSION +1 -1
- package/adapters/codex/model-bindings.json +7 -0
- package/adapters/codex/modes.json +220 -76
- package/adapters/codex/skills/agent-fit/SKILL.md +11 -10
- package/adapters/codex/skills/agent-fit/assets/AGENTS.fragment.md +2 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-execute.toml +0 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-review.toml +0 -2
- package/adapters/codex/skills/agent-fit/assets/codex/agents/task-scan.toml +0 -2
- package/adapters/codex/skills/agent-fit/evals/evals.json +44 -0
- package/adapters/codex/skills/agent-fit/references/calibration.md +16 -2
- package/adapters/codex/skills/agent-fit/references/configuration.md +11 -2
- package/adapters/codex/skills/agent-fit/references/dispatch-contract.md +15 -1
- package/adapters/codex/skills/agent-fit/references/failure-policy.md +7 -5
- package/adapters/codex/skills/agent-fit/references/task-routing.md +33 -13
- package/bin/agent-fit.mjs +17 -6
- package/docs/README.md +10 -12
- package/docs/implementation-review.md +24 -124
- package/docs/usage.md +99 -139
- package/lib/codex.mjs +25 -4
- package/lib/install.mjs +85 -21
- package/lib/models.mjs +6 -3
- package/lib/scopes.mjs +1 -1
- package/package.json +1 -1
- package/web/app.js +6 -6
package/README.md
CHANGED
|
@@ -1,172 +1,78 @@
|
|
|
1
1
|
# Agent Fit
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Agent Fit 根据任务复杂度、质量要求和预算,为已获授权的子任务匹配模型、推理强度和备用组合。先判断是否值得委派,再决定投入多少推理资源;支持研究、写作、数据分析、规划、开发与审查。模型档位、委派职责与配置来源均可查询和恢复。
|
|
6
|
-
|
|
7
|
-
[快速开始](#快速开始) · [四种档位](#四种档位) · [作用域](#按会话项目或全局配置) · [完整文档](docs/usage.md) · [更新记录](https://github.com/fanglinwei/agent-fit/releases)
|
|
8
|
-
|
|
9
|
-
## 功能特色
|
|
10
|
-
|
|
11
|
-
- **四种资源策略**:`cut / official / high / fire`,按 L1–L4 的推理需求配置模型与 effort;也可复制成自己的档位,设置每级主组合和备用。
|
|
12
|
-
- **同级任务候选**:在复杂度等级内区分机械处理、有界扫描、深度处理、复杂推理等任务,查询对应的完整组合;任务类型与委派职责分别配置。
|
|
13
|
-
- **会话、项目、全局三层作用域**:优先级为会话 > 项目 > 全局。聊天切换默认仅影响当前聊天,项目按 Git worktree 隔离,已开始任务沿用原快照。
|
|
14
|
-
- **CLI 与本地配置页面**:查看和编辑档位、浏览委派路由与选择依据、管理账号授权、预览和执行恢复。网页操作复用 CLI,只监听 `127.0.0.1`。
|
|
15
|
-
- **配置与模型检测分开**:安装、切档和保存配置只处理本地文件。需要时手动查询目录或验证模型,网页检测前确认主组合和费用。
|
|
16
|
-
- **配置与规则完整性分别检查**:识别共享 Skill 文件缺失、内容修改和清单异常,分别报告配置与规则修订号;规则异常时保留查询和安全恢复能力。
|
|
17
|
-
- **受控接续与完整交接**:区分前提缺失、质量升级与故障备用,保存任务完整快照;交接明确职责、权限、独占范围和验收,所有接续共用次数与预算。
|
|
18
|
-
- **可检查、可恢复**:提供状态诊断、职责核对、配置冲突保护及首次安装前的恢复基线;保留无关配置和管理区块之外的修改。
|
|
19
|
-
|
|
20
|
-
当前面向 **Codex**,需要 **Node.js 22+** 和支持独立角色 TOML 的 Codex 客户端。已在 macOS 与 Codex CLI 0.162.1 验证相关配置和账号接口,其他环境的验证范围见[实施验收记录](docs/implementation-review.md)。项目处于内测阶段;v0.7.4 按全新安装提供,不增加旧版本配置兼容。
|
|
3
|
+
为已获授权的 Codex 子任务选择模型与推理强度,支持会话、项目和全局档位。CLI 与本地网页共用配置,主代理按 Skill 决定是否委派并验收结果。
|
|
21
4
|
|
|
22
5
|
## 快速开始
|
|
23
6
|
|
|
24
|
-
|
|
7
|
+
需要 Node.js 22+。npm 包名为 [`@fanglinwei/agent-fit`](https://www.npmjs.com/package/@fanglinwei/agent-fit),命令与 Skill 名为 `agent-fit`。
|
|
8
|
+
|
|
9
|
+
从 [GitHub Releases](https://github.com/fanglinwei/agent-fit/releases/latest) 下载本版安装包:
|
|
25
10
|
|
|
26
11
|
```sh
|
|
27
|
-
npm install -g ./fanglinwei-agent-fit-0.
|
|
12
|
+
npm install -g ./fanglinwei-agent-fit-0.9.0.tgz
|
|
28
13
|
agent-fit setup --mode official --dry-run
|
|
29
14
|
agent-fit setup --mode official
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
npm 包名为 [`@fanglinwei/agent-fit`](https://www.npmjs.com/package/@fanglinwei/agent-fit),安装后的命令和 Skill 名为 `agent-fit`。也可用 `npm install -g @fanglinwei/agent-fit` 获取 npm 当前已发布版本;GitHub Release 与 npm registry 的版本以各自页面为准。
|
|
33
|
-
|
|
34
|
-
**已有其他版本配置时,不要直接用新版覆盖。** 先保留需要的自定义方案,并用原版本 CLI 对原绑定 home 按[恢复与卸载](#恢复与卸载)完成预览及实际恢复,再安装新版并重新 setup。v0.7.4 不自动迁移旧档位或恢复记录。
|
|
35
|
-
|
|
36
|
-
**首次配置完成后重启 Codex。** 安装 npm 包本身不会修改 Codex;`setup` 才会写入四个委派角色、AGENTS 管理区块和档位数据,并在共享 Skill 不存在时安装规则。默认目标为 `CODEX_HOME` 或 `~/.codex`,可通过 `--codex-home "/path/to/codex-home"` 指定独立目录。
|
|
37
|
-
|
|
38
|
-
Skill 默认放在 `~/.agents/skills/agent-fit/`,可由 CCSwitch 统一管理。动态档位存于对应 home 的 `.agent-fit/current-mode.json`,多个 home 共用规则但配置独立。`status`、`explain` 和 `skill path` 只读;日常切档和 `restore` 不改写或删除共享 Skill。
|
|
39
|
-
|
|
40
|
-
已有共享规则需要单独更新:先执行 `agent-fit skill update --dry-run`,核对后再执行 `agent-fit skill update`;`setup` 不覆盖现有共享规则。发现用户修改或归属冲突时保留现场,不直接删除目录来绕过保护。完整边界见[Skill 目录说明](docs/usage.md#skill-目录与旧安装迁移)。
|
|
41
|
-
|
|
42
|
-
打开本地配置页面:
|
|
43
|
-
|
|
44
|
-
```sh
|
|
45
15
|
agent-fit serve --open
|
|
46
16
|
```
|
|
47
17
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
日常全局、项目和会话切档,以及模型与 effort 调整无需重启;后续新任务读取新选择。更新基础 Skill、AGENTS 或角色职责,以及恢复原配置后仍需重启。
|
|
51
|
-
|
|
52
|
-
## Marketplace 插件
|
|
53
|
-
|
|
54
|
-
仓库同时提供 Codex marketplace 插件,直接复用现有 Skill:
|
|
55
|
-
|
|
56
|
-
- marketplace 清单:`.agents/plugins/marketplace.json`。
|
|
57
|
-
- 插件清单:`.codex-plugin/plugin.json`,通过 `skills` 指向 `adapters/codex/skills/`。
|
|
58
|
-
- 在 Codex 的插件管理中添加 GitHub 仓库 `https://github.com/fanglinwei/agent-fit` 作为 marketplace 来源,选择 **Agent Fit** 安装并启用。首次安装后重启 Codex,使插件 Skill 可被发现。
|
|
59
|
-
- 本地验证时可将当前仓库作为 marketplace 来源;清单中的 `source.path` 相对于仓库根目录解析。
|
|
60
|
-
|
|
61
|
-
插件安装提供规则;运行依赖仍按上面的快速开始安装 `@fanglinwei/agent-fit` 并执行 `setup`。已有配置无需重新 setup。插件不会自动运行命令、切档、检测模型或修改账号。使用时可要求“使用 Agent Fit 查看当前有效档位”。
|
|
18
|
+
npm 安装只提供工具,`setup` 才配置 Codex。默认目标为 `CODEX_HOME` 或 `~/.codex`;独立目录全程添加 `--codex-home "/path/to/codex-home"`。首次配置、基础规则更新或恢复后重启 Codex,日常切档无需重启。
|
|
62
19
|
|
|
63
|
-
CLI
|
|
20
|
+
已有其他版本配置时,先保留所需自定义方案,用原版本 CLI 对原绑定 home 预览并实际恢复,再安装新版。版本与发行包见 [GitHub Releases](https://github.com/fanglinwei/agent-fit/releases);本地安装和 Skill 更新见[使用说明](docs/usage.md#安装与配置)。
|
|
64
21
|
|
|
65
|
-
##
|
|
22
|
+
## 选择与查询
|
|
66
23
|
|
|
67
|
-
| 档位 |
|
|
24
|
+
| 档位 | 策略 |
|
|
68
25
|
| --- | --- |
|
|
69
|
-
| `cut` · 经济 |
|
|
70
|
-
| `official` · 官方 |
|
|
71
|
-
| `high` · 高级 |
|
|
72
|
-
| `fire` · 全开 |
|
|
26
|
+
| `cut` · 经济 | 较轻组合处理容易核验的任务,复杂部分提高等级 |
|
|
27
|
+
| `official` · 官方 | 首次配置默认;依据官方建议制定的本地映射 |
|
|
28
|
+
| `high` · 高级 | 按预设使用高强度组合 |
|
|
29
|
+
| `fire` · 全开 | 旗舰用途 / ultra,委派前须通过当前会话的实际验证 |
|
|
73
30
|
|
|
74
31
|
```sh
|
|
75
32
|
agent-fit mode list
|
|
76
|
-
agent-fit mode show official
|
|
77
33
|
agent-fit mode set cut
|
|
78
34
|
agent-fit status --details
|
|
35
|
+
agent-fit explain --level L2 --task bounded --role task_execute --json
|
|
79
36
|
```
|
|
80
37
|
|
|
81
|
-
L1–L4
|
|
82
|
-
|
|
83
|
-
### 查询同级任务候选
|
|
84
|
-
|
|
85
|
-
```sh
|
|
86
|
-
# 确定性机械任务
|
|
87
|
-
agent-fit explain --level L1 --task mechanical --role task_execute --json
|
|
88
|
-
|
|
89
|
-
# 有界扫描与复杂推理
|
|
90
|
-
agent-fit explain --level L1 --task scan --role task_review --json
|
|
91
|
-
agent-fit explain --level L3 --task reasoning --role task_execute --json
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
`explain` 只查询配置,不调用模型或创建子代理。复杂度、任务类型和职责由主代理判断;返回值包含主组合、备用、权限契约及配置来源。未配置的显式候选会报错,不从其他档位补值。支持的类型和编辑方法见[同级任务候选](docs/usage.md#同级任务候选)。
|
|
95
|
-
|
|
96
|
-
明确选择 `high / fire` 即授权其展示的最高强度组合,预算和宿主支持仍需满足;`fire` 另外要求当前会话的实际调用和可信身份验证。预览档位不构成选择,模型目录列出也不证明实际可调用。
|
|
97
|
-
|
|
98
|
-
## 按会话、项目或全局配置
|
|
99
|
-
|
|
100
|
-
```sh
|
|
101
|
-
# CLI 默认操作全局;此处显式写出作用域
|
|
102
|
-
agent-fit mode set official --scope global
|
|
103
|
-
|
|
104
|
-
# 仅对指定项目生效
|
|
105
|
-
agent-fit mode set cut --scope project --project "/path/to/project"
|
|
106
|
-
|
|
107
|
-
# 恢复项目对全局档位的继承
|
|
108
|
-
agent-fit mode clear --scope project --project "/path/to/project"
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
在 Codex 聊天中用 `$agent-fit` 要求切档时,默认只修改当前会话;明确要求后才修改项目或全局。CLI 操作会话时须绑定目标项目与聊天线程,具体参数见[作用域说明](docs/usage.md#全局项目与会话)。项目和会话配置保存在绑定 home 中,不写入项目仓库。
|
|
112
|
-
|
|
113
|
-
每次委派保存完整档位快照,重试、质量升级和故障备用沿用该快照。切档影响后续新任务,不改变正在执行的任务,也不重置委派次数。
|
|
114
|
-
|
|
115
|
-
## 自定义档位
|
|
116
|
-
|
|
117
|
-
复制现有档位,再调整所需等级:
|
|
118
|
-
|
|
119
|
-
```sh
|
|
120
|
-
agent-fit mode create "我的研究方案" --from official
|
|
121
|
-
agent-fit mode configure "我的研究方案" \
|
|
122
|
-
--level L3 --model gpt-6-astra --effort low \
|
|
123
|
-
--fallback-model gpt-6.1-sol --fallback-effort high
|
|
124
|
-
agent-fit mode set "我的研究方案"
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
复制包含四级基线、同级任务候选及各自备用,不自动激活。CLI 可修改单级基线;网页或完整 JSON 可编辑候选。局部编辑继承来的自定义档位会生成局部副本,避免覆盖其他作用域。详见[自定义档位](docs/usage.md#自定义档位)。
|
|
38
|
+
L1–L4 表示任务推理需求,`--task` 查询同级候选;cut/official 包含视觉、电脑操作和写作专长路线。`explain` 只查配置,不调用模型或创建子代理。内置档位按用途绑定模型,可[显式预览和应用换代](docs/usage.md#模型绑定与换代)。完整组合、职责和选择边界见[使用说明](docs/usage.md#任务等级与委派职责)与 [Skill](adapters/codex/skills/agent-fit/SKILL.md)。
|
|
128
39
|
|
|
129
|
-
|
|
40
|
+
有效档位按 **会话 > 项目 > 全局** 整份选择。CLI 默认全局,聊天中用 `$agent-fit` 切档默认仅当前会话;项目和会话操作见[作用域说明](docs/usage.md#全局项目与会话)。自定义、账号与手动模型检查也见使用说明;配置操作不自动发送模型请求。
|
|
130
41
|
|
|
131
|
-
|
|
132
|
-
# 查询授权状态与模型目录,不发起推理
|
|
133
|
-
agent-fit models check
|
|
134
|
-
|
|
135
|
-
# 手动验证当前档位的主模型组合,可能产生费用
|
|
136
|
-
agent-fit models check --verify
|
|
137
|
-
```
|
|
42
|
+
## 子代理如何分工
|
|
138
43
|
|
|
139
|
-
|
|
44
|
+
主代理先用工具和按需加载的 Skills 完成能直接处理的工作。需要委派时,先说明要解决的具体约束,再按当前档位选择模型与推理强度;岗位名称和阶段数量不作为拆分依据。
|
|
140
45
|
|
|
141
|
-
|
|
46
|
+
- **委派须有收益**:上下文隔离、并行、独立验证或能力与成本匹配的收益,需要覆盖启动、交接、等待、汇总、验证和返工开销。用户明确要求的委派与独立复核仍须执行。
|
|
47
|
+
- **交接能够独立理解**:提供目标、可访问的权威材料及版本、已有修改、边界和验收。独立审查区分作者解释与已证实事实,不以作者结论为前提。
|
|
48
|
+
- **隔离分别核实**:新上下文、独立文件与受限权限是三件事。新线程不自动创建工作树或沙箱,也不能保证消除同模型盲区;共享产出指定唯一负责人。
|
|
49
|
+
- **结果精炼且可复核**:回传结论、产物、证据位置和验证状态,保留失败、反例与未知项。主代理负责最终设计、集成和关键验收。
|
|
50
|
+
- **完成即返回,按需复用**:复用须有上下文收益且满足独立性要求。原任务接续沿用快照与累计次数,新任务重新查询配置;所有派发仍受授权和预算约束。
|
|
142
51
|
|
|
143
|
-
|
|
52
|
+
完整规则以 [Skill](adapters/codex/skills/agent-fit/SKILL.md) 和[派发契约](adapters/codex/skills/agent-fit/references/dispatch-contract.md)为准。CLI 与规则辅助决策,不拦截宿主派发,也不强制提供文件或权限隔离。
|
|
144
53
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
共同规则包括先权衡委派收益与协调成本、保留用户授权和预算、区分复杂度与职责、明确独占写入范围、禁止递归委派,以及完成最小充分验证。质量升级与故障备用分别判断,初次派发、重试和接续共用每任务最多三次委派。
|
|
54
|
+
## Marketplace 插件
|
|
148
55
|
|
|
149
|
-
|
|
56
|
+
在 Codex 插件管理中添加仓库 `https://github.com/fanglinwei/agent-fit` 为 marketplace 来源,安装并启用 **Agent Fit**,然后重启 Codex。本地验证也可将当前仓库作为来源。
|
|
150
57
|
|
|
151
|
-
|
|
58
|
+
插件提供规则,仍需安装 CLI 并完成 `setup`。共享 Skill 与插件规则来自同一源码:共享版本通过 `agent-fit skill update` 更新,插件版本通过插件管理更新。二者应保持同版本;已有配置无需重新 setup。清单位于 `.agents/plugins/marketplace.json` 与 `.codex-plugin/plugin.json`。
|
|
152
59
|
|
|
153
60
|
## 恢复与卸载
|
|
154
61
|
|
|
155
|
-
|
|
62
|
+
卸载前先恢复原绑定 home:
|
|
156
63
|
|
|
157
64
|
```sh
|
|
158
65
|
agent-fit restore --dry-run
|
|
159
66
|
agent-fit restore && npm uninstall -g @fanglinwei/agent-fit
|
|
160
67
|
```
|
|
161
68
|
|
|
162
|
-
|
|
69
|
+
预览不算恢复完成;独立 home 的两次命令使用相同路径,多个 home 全部实际恢复成功后才卸载。失败或结果未知时保留工具和恢复记录。恢复完成后重启 Codex,完整保护边界见[恢复说明](docs/usage.md#恢复与卸载)。
|
|
163
70
|
|
|
164
71
|
## 文档与开发
|
|
165
72
|
|
|
166
|
-
- [
|
|
167
|
-
- [文档导航](docs/README.md)
|
|
168
|
-
- [
|
|
169
|
-
- [GitHub Releases](https://github.com/fanglinwei/agent-fit/releases):版本与发布说明。
|
|
73
|
+
- [使用说明](docs/usage.md):CLI、网页、作用域、自定义、模型检查与故障处理。
|
|
74
|
+
- [文档导航](docs/README.md):规则、验证边界及历史证据入口。
|
|
75
|
+
- [验证范围](docs/implementation-review.md):已有验收记录与未覆盖范围。
|
|
170
76
|
|
|
171
77
|
```sh
|
|
172
78
|
npm ci --ignore-scripts
|
|
@@ -174,8 +80,6 @@ npm test
|
|
|
174
80
|
npm pack
|
|
175
81
|
```
|
|
176
82
|
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
## License
|
|
83
|
+
打包生成 `fanglinwei-agent-fit-0.9.0.tgz`。浏览器检查见[开发验证](docs/usage.md#开发验证);唯一运行依赖为 [smol-toml](https://github.com/squirrelchat/smol-toml)。
|
|
180
84
|
|
|
181
85
|
[MIT](LICENSE) © 2026 fanglinwei.
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
0.
|
|
1
|
+
0.9.0
|