From eacb2580b0a2ef72d339d164c3fa8289f72174d4 Mon Sep 17 00:00:00 2001 From: XiaoDaiGua-Ray <51957438+XiaoDaiGua-Ray@users.noreply.github.com> Date: Thu, 5 Nov 2026 10:11:04 +0800 Subject: [PATCH] docs(harness): allow optional subagent delegation --- AGENTS.md | 1 + harness/README.md | 8 +++++++- harness/context/harness.md | 3 ++- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 0ea1faaa..1c40293a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,6 +4,7 @@ Vue 3 + TSX 中后台模板,包含后台应用、文档站与共享包。 - 需要定位实现时,从 [任务索引](llms.txt) 或 `pnpm harness context ` 选相关主题。跨模块变更再查 [架构地图](docs/architecture.md)。 - 先看 `git status`,保留已有改动。变更路由、持久化、请求或公共组件时,追踪调用方和现有数据契约。 +- 复杂任务中,宿主支持且当前权限允许时,主模型可按[分工约定](harness/README.md#按需使用-subagent)自行决定是否启用 subagent,无需为分工单独请示。主模型负责整合与最终验收。 - 新增或修改注释时遵循 [注释规范](docs/comment-style.md)。页面文案同时维护中英文,页面改动按 [Harness 指南](harness/README.md#浏览器验收) 验收。 - 完成实现后运行 `pnpm harness verify`,执行全量检查并留存报告。交付说明实际验证及未验证项。 - 使用当前源码、清单和锁文件核对工程事实。敏感数据不进入源码、提示词或证据。提交、推送与部署遵循用户授权。 diff --git a/harness/README.md b/harness/README.md index 5c1c9837..6f9dcbbd 100644 --- a/harness/README.md +++ b/harness/README.md @@ -6,7 +6,7 @@ 1. 查看 `git status`。用静态入口或 `pnpm harness context` 选择任务域;`pnpm harness context ` 显示对应索引及验证命令。跨域变更分别查看受影响的任务域。 2. 需要运行验证时,根据 `.nvmrc` 和 `package.json#packageManager` 选择运行时,首次执行 `pnpm install --frozen-lockfile` 和 `pnpm env:check`。 -3. 明确可观察的验收条件,追踪调用方和数据流后实施。多步迁移或跨会话接续时,记录范围、分阶段验收、关键决策与剩余项。可参考 [建设计划](plan.md)。 +3. 明确可观察的验收条件,按需决定是否使用 subagent,追踪调用方和数据流后实施。多步迁移或跨会话接续时,记录范围、分阶段验收、关键决策与剩余项。可参考 [建设计划](plan.md)。 4. 先运行定向验证,最后运行全量验收。 ```sh @@ -15,6 +15,12 @@ pnpm harness verify table-pro pnpm harness verify ``` +## 按需使用 subagent + +- **决定是否委派。** 子任务边界清楚、结果可独立验收,且并行调查、分头实现或独立复核的收益大于沟通与合并成本时,可以启用 subagent。简单任务、步骤相互依赖或需要频繁协调共享文件的任务,通常由主模型直接处理。宿主没有提供 subagent 或当前任务不允许委派时,主模型继续执行。 +- **划清任务边界。** 交代目标、相关任务域、验收条件及只读或可写范围。并行实现时,每个文件只交给一方修改;边界未定时可先委派只读调查。委派沿用用户授权和仓库规则。 +- **核对并整合结果。** 子代理回传发现、改动、实际验证及未验证项。主模型复核并整合结果;有实现改动时,由主模型执行全量验收。 + ## 工程约定 - UI 沿用 Vue 3 Composition API、`defineComponent` + TSX 与现有 SFC 的 `