mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-20 18:34:13 +08:00
docs(harness): allow optional subagent delegation
This commit is contained in:
parent
bb8a49ae1a
commit
eacb2580b0
@ -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`,执行全量检查并留存报告。交付说明实际验证及未验证项。
|
||||
- 使用当前源码、清单和锁文件核对工程事实。敏感数据不进入源码、提示词或证据。提交、推送与部署遵循用户授权。
|
||||
|
||||
@ -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。
|
||||
|
||||
@ -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) |
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user