From bc7bcb2fe1f808190ba0e2357e749a31fdbbee66 Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sat, 4 Jul 2026 09:26:04 +0900 Subject: [PATCH] =?UTF-8?q?docs(agent-button):=20=E6=8E=A5=E5=85=A5?= =?UTF-8?q?=E5=8C=85=E7=AE=80=E5=8C=96=E4=B8=BA=E5=8D=95=E6=A1=A3=EF=BC=8C?= =?UTF-8?q?=E5=8E=BB=E9=99=A4=E6=9C=80=E5=B0=8F=E6=8E=A5=E5=85=A5=E6=96=B9?= =?UTF-8?q?=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ai-context/agent-button-system.md | 39 +++++--------------------- 1 file changed, 7 insertions(+), 32 deletions(-) diff --git a/docs/ai-context/agent-button-system.md b/docs/ai-context/agent-button-system.md index 9dcda00..a9256f1 100644 --- a/docs/ai-context/agent-button-system.md +++ b/docs/ai-context/agent-button-system.md @@ -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/.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 开放规范即可。