feature/architecture-guides
main
系统缺少面向新人与新任务的现状导览。本 PR 在 docs/guides/ 新增五篇参考文档: 整体结构与架构、意图识别、任务规划与执行、小队与子 Agent 启动、小队工作机制。
docs/guides/
所有代码引用锚定到 Dev 组合 218fc4b1ba00b0a03b5bb79f292b3eba6c987a58(R0), 引用的函数入口行号逐一 grep 定位核验;实例章节含 intentctl explain 打分/填槽/ 多意图裁决实测轨迹、agent-squad demo 全流程实测输出与真实工作区目录树、 ClaimGate 拦截机制走查。
218fc4b1ba00b0a03b5bb79f292b3eba6c987a58
intentctl explain
agent-squad demo
git diff --check
.task/feature-architecture-guides.md
纯文档新增(5 文件,+1110 行);无代码/契约/配置影响。
218fc4b1
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。
No dependencies set.
The note is not visible to the blocked user.
Why
系统缺少面向新人与新任务的现状导览。本 PR 在
docs/guides/新增五篇参考文档:整体结构与架构、意图识别、任务规划与执行、小队与子 Agent 启动、小队工作机制。
所有代码引用锚定到 Dev 组合
218fc4b1ba00b0a03b5bb79f292b3eba6c987a58(R0),引用的函数入口行号逐一 grep 定位核验;实例章节含
intentctl explain打分/填槽/多意图裁决实测轨迹、
agent-squad demo全流程实测输出与真实工作区目录树、ClaimGate 拦截机制走查。
Evidence
git diff --check通过;五篇互链相对路径全部可解析(SRC=SELF).task/feature-architecture-guides.md(Dev PR 见Refs)Impact
纯文档新增(5 文件,+1110 行);无代码/契约/配置影响。
Refs
feature/architecture-guides(gitlink 提升见 Dev 仓同名 PR)218fc4b1