@betterdanlins/ai-memory 0.3.0 → 0.5.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 +71 -3
- package/README.zh-CN.md +71 -3
- package/bin/cli.js +105 -3
- package/package.json +1 -1
- package/src/framework.js +57 -17
- package/src/managed-blocks.js +62 -0
- package/src/manifest.js +7 -1
- package/src/model-routing.js +108 -0
- package/src/workflow.js +185 -0
- package/templates/claude/.claude/agents/economy-test-worker.md +8 -0
- package/templates/claude/.claude/agents/premium-implementer.md +8 -0
- package/templates/claude/.claude/agents/premium-planner.md +8 -0
- package/templates/claude/.claude/agents/premium-reviewer.md +8 -0
- package/templates/claude/.claude/agents/standard-implementer.md +8 -0
- package/templates/claude/.claude/agents/standard-test-worker.md +8 -0
- package/templates/claude/.claude/skills/model-routing/SKILL.md +6 -0
- package/templates/claude/CLAUDE.md +6 -0
- package/templates/codex/.agents/skills/model-routing/SKILL.md +6 -0
- package/templates/codex/.codex/agents/economy_test_worker.toml +6 -0
- package/templates/codex/.codex/agents/premium_implementer.toml +6 -0
- package/templates/codex/.codex/agents/premium_planner.toml +6 -0
- package/templates/codex/.codex/agents/premium_reviewer.toml +6 -0
- package/templates/codex/.codex/agents/standard_implementer.toml +6 -0
- package/templates/codex/.codex/agents/standard_test_worker.toml +6 -0
- package/templates/codex/AGENTS.md +6 -0
- package/templates/common/.ai/README.md +4 -1
- package/templates/common/.ai/config/model-routing.json +5 -0
- package/templates/common/.ai/runs/.gitignore.template +2 -0
- package/templates/common/.ai/skills/critic.md +1 -0
- package/templates/common/.ai/skills/delivery-readiness.md +2 -0
- package/templates/common/.ai/skills/feature-design.md +2 -0
- package/templates/common/.ai/skills/model-routing.md +39 -0
- package/templates/common/.ai/skills/requirements-flow.md +2 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# 分阶段模型路由与交接
|
|
2
|
+
|
|
3
|
+
模型路由只选择现有阶段的执行者,不得增加或跳过 S/M/L 风险流程。读取 `.ai/config/model-routing.json`:`inherit` 保持当前模型;`balanced` 使用高级规划、中等实现、便宜测试和高级审查;`quality` 提高实现与诊断等级。
|
|
4
|
+
|
|
5
|
+
执行 CLI 时优先使用当前环境的 `ai-memory`;若命令不可用,使用 `npx --yes @betterdanlins/ai-memory@{{frameworkVersion}}`。必须固定与项目框架一致的版本,不使用未固定的 latest。
|
|
6
|
+
|
|
7
|
+
## 执行协议
|
|
8
|
+
|
|
9
|
+
1. 先由 requirements-flow / feature-design 判断是否需要该阶段,再解析模型等级。
|
|
10
|
+
2. 跨模型执行前,用 `ai-memory workflow prepare` 从正式需求、设计和计划生成 `.ai/runs/<feature>/handoff.json`。
|
|
11
|
+
3. 执行者先运行 `ai-memory workflow verify`,再读取 handoff 中的全部输入;不得用对话摘要替代正式文档。
|
|
12
|
+
4. 输入缺失、哈希变化、路由变化或存在未决问题时停止,不得猜测。
|
|
13
|
+
5. 实现结束后在同一 run 目录写 `<stage>-result.json`,记录变更文件、验收覆盖、测试、设计偏差和未决风险。
|
|
14
|
+
6. reviewer 第一轮只读;修复交给 implementer,修复后重新审查。
|
|
15
|
+
|
|
16
|
+
## 能力边界与升级
|
|
17
|
+
|
|
18
|
+
- `premium`:需求定稿、重大方案、计划、对抗性测试和最终审查。
|
|
19
|
+
- `standard`:按已批准计划实现、普通失败诊断。
|
|
20
|
+
- `economy`:根据明确测试矩阵补机械性测试;不得修改生产代码或重新解释契约。
|
|
21
|
+
- `none`:直接运行确定性命令,不调用模型。
|
|
22
|
+
- economy 无法理解契约或发现生产缺陷 → standard;standard 发现设计缺口或连续两次失败 → premium。
|
|
23
|
+
- 安全、权限、资金、隐私、数据迁移和并发问题直接使用 premium。
|
|
24
|
+
|
|
25
|
+
模型不可用时可降级为 `inherit`,但必须报告一次;不得静默把高风险阶段降为 economy。
|
|
26
|
+
|
|
27
|
+
## 交接回执最小字段
|
|
28
|
+
|
|
29
|
+
```json
|
|
30
|
+
{
|
|
31
|
+
"stage": "implementation",
|
|
32
|
+
"status": "completed",
|
|
33
|
+
"changedFiles": [],
|
|
34
|
+
"acceptanceCoverage": {},
|
|
35
|
+
"tests": [],
|
|
36
|
+
"designDeviations": [],
|
|
37
|
+
"unresolvedRisks": []
|
|
38
|
+
}
|
|
39
|
+
```
|
|
@@ -23,6 +23,8 @@
|
|
|
23
23
|
5. 按下方路由选择下一步,不在本流程中启动重复 brainstorming。
|
|
24
24
|
6. 更新 `project-state.md` 为 `finalized`;在 `features/<需求名>.md` 记录外部契约与关键决策,并更新 MEMORY 索引。
|
|
25
25
|
|
|
26
|
+
若 `.ai/config/model-routing.json` 的 profile 不是 `inherit`,定稿前按 `.ai/skills/model-routing.md` 为 `requirement-finalize` 准备并校验 handoff,再使用对应等级执行者。模型路由不得改变下方 S/M/L 流程深度。
|
|
27
|
+
|
|
26
28
|
## 风险路由
|
|
27
29
|
|
|
28
30
|
| 等级 | 判断 | 下一步 |
|