From bc7d3cca17843a6149002bea41e26658478f9dc6 Mon Sep 17 00:00:00 2001 From: WuYongJie Date: Fri, 10 Jul 2026 11:27:56 +0800 Subject: [PATCH] =?UTF-8?q?chore(=E5=8D=8F=E4=BD=9C):=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E5=AD=90=E4=BB=A3=E7=90=86=E5=B7=A5=E4=BD=9C?= =?UTF-8?q?=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 3e48a7d..65dd7c2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,11 +15,26 @@ - 本项目默认采用官方 `lead + 可复用子代理编排`。 - 用户只提目标、问题、期望效果，不需要做技术判断。 - 主代理默认承担 `lead`：负责理解需求、拆任务、判断是否启用子代理、整合结果、统一汇报。 +- 主代理在 `spawn_agent` 前，默认先执行一次 `list_agents`，优先检查当前是否已有可复用的同职责子代理。 - 本项目默认团队分工： - `frontend-worker`：使用官方 `worker`，只负责前端文件。 - `backend-worker`：使用官方 `worker`，只负责后端 / 数据库相关文件。 - `review-explorer`：使用官方 `explorer`，只负责代码审查、找问题、提风险，不直接改代码。 - 子代理按职责复用，不必每次换一套；但仍遵守官方能力边界，不自定义内建类型。 +- 默认固定复用以上 3 个命名子代理；同职责任务优先继续派发给现有同名子代理，不要为相同职责反复新开线程。 +- 默认同职责只保留 1 个活跃子代理： + - 前端任务优先发给 `frontend-worker` + - 后端任务优先发给 `backend-worker` + - 审查、排查风险优先发给 `review-explorer` +- 只有以下情况才允许新开同职责子代理： + - 当前不存在该职责子代理 + - 现有子代理已经关闭或不可用 + - 任务明确需要并行，且写入范围完全不重叠 +- 给已存在子代理继续分派工作时，优先使用 `assign_task` 或 `send_message`，不要为了“清空上下文”而随手重建。 +- 同一个功能周期内，尽量保留子代理连续上下文；不要刚做完一个相邻子任务就关闭再重开，避免重复解释背景。 +- 只有在该子代理本轮职责已经完成、后续短期内不再需要，或继续保留会明显增加干扰时，才执行 `close_agent`。 +- 如果现有同职责子代理正在处理相关任务，主代理应先判断是否可以复用同一线程继续推进；不要因为等待而机械式再开一个同类子代理。 +- 子代理任务描述必须写清楚文件归属和边界，避免前后端、审查与实现之间职责漂移。 - 不魔改为“常驻团队系统”；子代理只用官方支持的能力边界。 - 本项目内所有子代理默认统一使用 `gpt-5.4`。 - 所有 `worker` 类子代理固定使用 `gpt-5.4 + xhigh` 思考等级。