docs(agent-button): 接入包简化为单档,去除最小接入方案
This commit is contained in:
parent
ccf87ae09a
commit
bc7bcb2fe1
@ -153,49 +153,24 @@ acceptance 是 agent 自验的唯一判断依据,必须是可执行断言:
|
||||
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
|
||||
| 前端单元测试 | `pnpm test` | exit 0,无 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/modules/<id>.md` | 文件写入成功,格式合法 |
|
||||
|
||||
## 分发给子项目的方案
|
||||
|
||||
### 完整接入(长期项目推荐)
|
||||
接入包只有一档,要么接,要么不接。
|
||||
|
||||
```
|
||||
接入包
|
||||
├── AGENTS.md 模板 ← 含方针 + 按钮清单占位 + 降级约定
|
||||
├── .blueprint/CONVENTIONS.md ← 含 acceptance 写法规范
|
||||
├── .blueprint/CONVENTIONS.md ← 含 acceptance 写法规范 + 蓝图工作流
|
||||
├── lefthook.yml ← git hooks(模型无关验证层)
|
||||
└── .gitea/workflows/ci.yml ← CI/CD(模型无关验证层)
|
||||
```
|
||||
|
||||
### 最小接入(轻量项目)
|
||||
|
||||
```
|
||||
接入包
|
||||
├── AGENTS.md 模板 ← 含方针 + 降级约定
|
||||
├── .agent/task.md 模板 ← 最小目标持久化(跨会话续接)
|
||||
└── lefthook.yml ← 最小验证层
|
||||
```
|
||||
|
||||
`.agent/task.md` 格式:
|
||||
|
||||
```markdown
|
||||
## 当前目标
|
||||
<人填写>
|
||||
|
||||
## Acceptance
|
||||
- <可执行断言 1>
|
||||
- <可执行断言 2>
|
||||
|
||||
## 状态
|
||||
in_progress / blocked / done
|
||||
|
||||
## 阻塞原因(blocked 时填)
|
||||
自验失败 N 次,具体问题:<描述>
|
||||
需要人决策:<具体问题>
|
||||
```
|
||||
|
||||
子项目只需填入:
|
||||
- AGENTS.md 里 agent 按钮清单的具体命令
|
||||
子项目接入后需要自己填入:
|
||||
- AGENTS.md 里 agent 按钮清单的具体命令和通过标准
|
||||
- 任务卡 acceptance 字段的可执行断言
|
||||
|
||||
> 没有蓝图就没有飞轮数据,炼境对该项目的感知断链。不接入蓝图的项目不应通过炼境分发接入包,直接使用 AGENTS.md 开放规范即可。
|
||||
|
||||
Loading…
Reference in New Issue
Block a user