Add architecture guides with worked examples #48

Merged
weichen merged 2 commits from feature/architecture-guides into main 2026-10-08 09:37:36 +00:00
Owner

Why

系统缺少面向新人与新任务的现状导览。本 PR 在 docs/guides/ 新增五篇参考文档:
整体结构与架构、意图识别、任务规划与执行、小队与子 Agent 启动、小队工作机制。

所有代码引用锚定到 Dev 组合 218fc4b1ba00b0a03b5bb79f292b3eba6c987a58(R0),
引用的函数入口行号逐一 grep 定位核验;实例章节含 intentctl explain 打分/填槽/
多意图裁决实测轨迹、agent-squad demo 全流程实测输出与真实工作区目录树、
ClaimGate 拦截机制走查。

Evidence

  • git diff --check 通过;五篇互链相对路径全部可解析(SRC=SELF)
  • 锚点核验与实测命令记录见 Dev 仓任务卡
    .task/feature-architecture-guides.md(Dev PR 见Refs)
  • 注意:guides 实例节声明"模型输出为示意、机制与工具名为代码实测"

Impact

纯文档新增(5 文件,+1110 行);无代码/契约/配置影响。

Refs

  • Dev 组合任务:feature/architecture-guides(gitlink 提升见 Dev 仓同名 PR)
  • 基准:Agent-System-Dev 218fc4b1
## Why 系统缺少面向新人与新任务的现状导览。本 PR 在 `docs/guides/` 新增五篇参考文档: 整体结构与架构、意图识别、任务规划与执行、小队与子 Agent 启动、小队工作机制。 所有代码引用锚定到 Dev 组合 `218fc4b1ba00b0a03b5bb79f292b3eba6c987a58`(R0), 引用的函数入口行号逐一 grep 定位核验;实例章节含 `intentctl explain` 打分/填槽/ 多意图裁决实测轨迹、`agent-squad demo` 全流程实测输出与真实工作区目录树、 ClaimGate 拦截机制走查。 ## Evidence - `git diff --check` 通过;五篇互链相对路径全部可解析(SRC=SELF) - 锚点核验与实测命令记录见 Dev 仓任务卡 `.task/feature-architecture-guides.md`(Dev PR 见Refs) - 注意:guides 实例节声明"模型输出为示意、机制与工具名为代码实测" ## Impact 纯文档新增(5 文件,+1110 行);无代码/契约/配置影响。 ## Refs - Dev 组合任务:`feature/architecture-guides`(gitlink 提升见 Dev 仓同名 PR) - 基准:Agent-System-Dev `218fc4b1`
weichen added 2 commits 2026-10-08 09:36:05 +00:00
Why: 系统缺少面向新人与新任务的现状导览;把结构/意图识别/任务执行/小队
四条主线的架构、模型与调用链整理成五篇参考文档,降低跨仓定位成本。

Evidence: 锚点核验于 Dev 组合 218fc4b1ba00b0a03b5bb79f292b3eba6c987a58
(2026-10-08,引用的函数入口行号逐一 grep 定位);git diff --check 通过;
五篇互链相对路径全部可解析。SRC=SELF(本地核验,任务卡有记录)。

Impact: 纯文档新增(docs/guides 五篇),无代码/契约/配置影响。

Refs: Dev 任务分支 feature/architecture-guides(R0 218fc4b1)。
Why: 补充实例让导览可对照实操:意图打分/填槽/多意图裁决给出
intentctl explain 实测轨迹(含样例意图、歧义、优先级 tie-break、
能力目录),任务执行给出工具清单与典型回合走查(含 ClaimGate
三类拦截),小队给出 agent-squad demo 全流程实测与真实工作区
目录树/TASK.md 实拍;并修正事实:默认意图目录为空、插件 overlay
与 registry loader 两种文件形态不同。

Evidence: intentctl explain/catalog 与 agent-squad demo 为 2026-10-08
本地实测输出(命令见各节);锚点仍为 Dev R0 218fc4b1;git diff
--check 通过;五篇互链全部可解析。SRC=SELF。

Impact: 仅文档增补(02/03/04/05 四篇),无代码影响。

Refs: Dev 任务分支 feature/architecture-guides。
weichen merged commit 4e57196a8e into main 2026-10-08 09:37:36 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: weichen/Agent-System-Documents#48