docs(agent-button): 接入包简化为单档,去除最小接入方案

This commit is contained in:
lanrtop 2026-07-04 09:26:04 +09:00
parent ccf87ae09a
commit bc7bcb2fe1

View File

@ -153,49 +153,24 @@ acceptance 是 agent 自验的唯一判断依据,必须是可执行断言:
| TypeScript 类型检查 | `pnpm typecheck` | 无输出exit 0 | | TypeScript 类型检查 | `pnpm typecheck` | 无输出exit 0 |
| 前端单元测试 | `pnpm test` | exit 0无 FAILED | | 前端单元测试 | `pnpm test` | exit 0无 FAILED |
| Rust 单元测试 | `cargo test`src-tauri/ 目录) | 无 FAILED | | Rust 单元测试 | `cargo test`src-tauri/ 目录) | 无 FAILED |
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表21 个工具) | 返回 JSON无 error 字段 | | MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON无 error 字段 |
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 | | 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 | | 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |
## 分发给子项目的方案 ## 分发给子项目的方案
### 完整接入(长期项目推荐) 接入包只有一档,要么接,要么不接。
``` ```
接入包 接入包
├── AGENTS.md 模板 ← 含方针 + 按钮清单占位 + 降级约定 ├── AGENTS.md 模板 ← 含方针 + 按钮清单占位 + 降级约定
├── .blueprint/CONVENTIONS.md ← 含 acceptance 写法规范 ├── .blueprint/CONVENTIONS.md ← 含 acceptance 写法规范 + 蓝图工作流
├── lefthook.yml ← git hooks模型无关验证层 ├── lefthook.yml ← git hooks模型无关验证层
└── .gitea/workflows/ci.yml ← CI/CD模型无关验证层 └── .gitea/workflows/ci.yml ← CI/CD模型无关验证层
``` ```
### 最小接入(轻量项目) 子项目接入后需要自己填入:
- AGENTS.md 里 agent 按钮清单的具体命令和通过标准
```
接入包
├── AGENTS.md 模板 ← 含方针 + 降级约定
├── .agent/task.md 模板 ← 最小目标持久化(跨会话续接)
└── lefthook.yml ← 最小验证层
```
`.agent/task.md` 格式:
```markdown
## 当前目标
<人填写>
## Acceptance
- <可执行断言 1>
- <可执行断言 2>
## 状态
in_progress / blocked / done
## 阻塞原因blocked 时填)
自验失败 N 次,具体问题:<描述>
需要人决策:<具体问题>
```
子项目只需填入:
- AGENTS.md 里 agent 按钮清单的具体命令
- 任务卡 acceptance 字段的可执行断言 - 任务卡 acceptance 字段的可执行断言
> 没有蓝图就没有飞轮数据,炼境对该项目的感知断链。不接入蓝图的项目不应通过炼境分发接入包,直接使用 AGENTS.md 开放规范即可。