docs(harness): allow optional subagent delegation

This commit is contained in:
XiaoDaiGua-Ray 2026-11-05 10:11:04 +08:00
parent bb8a49ae1a
commit eacb2580b0
No known key found for this signature in database
3 changed files with 10 additions and 2 deletions

View File

@ -4,6 +4,7 @@ Vue 3 + TSX 中后台模板,包含后台应用、文档站与共享包。
- 需要定位实现时,从 [任务索引](llms.txt) 或 `pnpm harness context <scope>` 选相关主题。跨模块变更再查 [架构地图](docs/architecture.md)。
- 先看 `git status`,保留已有改动。变更路由、持久化、请求或公共组件时,追踪调用方和现有数据契约。
- 复杂任务中,宿主支持且当前权限允许时,主模型可按[分工约定](harness/README.md#按需使用-subagent)自行决定是否启用 subagent,无需为分工单独请示。主模型负责整合与最终验收。
- 新增或修改注释时遵循 [注释规范](docs/comment-style.md)。页面文案同时维护中英文,页面改动按 [Harness 指南](harness/README.md#浏览器验收) 验收。
- 完成实现后运行 `pnpm harness verify`,执行全量检查并留存报告。交付说明实际验证及未验证项。
- 使用当前源码、清单和锁文件核对工程事实。敏感数据不进入源码、提示词或证据。提交、推送与部署遵循用户授权。

View File

@ -6,7 +6,7 @@
1. 查看 `git status`。用静态入口或 `pnpm harness context` 选择任务域;`pnpm harness context <scope>` 显示对应索引及验证命令。跨域变更分别查看受影响的任务域。
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 的 `<script setup lang="ts">`,优先复用 Naive UI 和项目组件。图表使用 ECharts。

View File

@ -1,10 +1,11 @@
# Harness、索引和验证证据
用于新增或改动任务索引、回归范围、命令和本地报告。执行方式见 [Harness README](../README.md)。
用于调整任务协作、索引、回归范围、命令和本地报告。执行方式见 [Harness README](../README.md)。
| 要查什么 | 先读 | 接着追踪 |
| -------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| 助手从哪里进入、怎么选主题 | [根约定](../../AGENTS.md)、[静态任务入口](../../llms.txt) | [主题索引](./)、[跨模块地图](../../docs/architecture.md) |
| 复杂任务怎么分工 | [按需使用 subagent](../README.md#按需使用-subagent) | [根约定](../../AGENTS.md) |
| CLI、上下文与定向目标 | [任务注册表](../scopes.json)、[CLI 实现](../run.mjs) | [CLI 回归](../../__test__/harness/cli.spec.ts)、[根检查命令](../../package.json) |
| 全量验证、报告和历史决策 | [验证与证据](../README.md#验收与证据)、[CI](../../.github/workflows/ci.yaml) | [建设计划与设计自审](../plan.md)、[工具链记录](../../docs/toolchain-upgrade.md) |