claude-code-best/docs
CyberScrubber 81073135e2
docs: 审校 Agent 文档术语与架构描述准确性(docs/agent) (#231)
基于源码验证和官方文档对照,修正三份 Agent 文档的内容准确性:

coordinator-and-swarm.mdx:
- 对齐官方术语:Leader→Team Lead, teammate→Teammate, 引入 Mailbox 消息系统
- 修正 Swarm 门控为 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1(原文"默认启用"不准确)
- 拓扑描述改为"星型+P2P混合"(官方有 Team Lead 角色,非纯网状)
- 新增架构组件表、Mailbox 消息系统、Hook 事件(TeammateIdle/TaskCreated/TaskCompleted)、限制说明
- 新增持久化存储路径(~/.claude/teams/, ~/.claude/tasks/)
- 移除虚构的"高水位标记"(claimTask 仅使用文件锁)
- 修正 Scratchpad 描述(Workers 获得,非 Coordinator 拥有)
- 修复引号不匹配

sub-agents.mdx:
- 修正为三路径路由(命名 Agent / Fork / GP 回退),原文仅两种
- 补充 isForkSubagentEnabled() 三前提(feature flag + 非Coordinator + 非非交互式)
- 新增模型解析优先级(4级链 + inherit 运行时解析)
- 新增内置 Agent 表(Explore/Plan/GP/statusline-setup/claude-code-guide)
- 新增 Hook 事件表(frontmatter + settings.json 双级别)
- 补充异步生命周期完整链路(finalizeAgentTool → getWorktreeResult)
- 补充 transcript 存储路径和结果格式细节

worktree-isolation.mdx:
- 区分 createWorktreeForSession vs createAgentWorktree 两种函数
- 修正清理机制为 cleanupWorktreeIfNeeded(非 ExitWorktreeTool 手动操作)
- 补充 usedSparsePaths 字段
2026-04-10 18:00:42 +08:00
..
agent docs: 审校 Agent 文档术语与架构描述准确性(docs/agent) (#231) 2026-04-10 18:00:42 +08:00
context docs: fix documentation deviations from source code (#220) 2026-04-09 17:53:11 +08:00
conversation docs: fix documentation deviations from source code (#220) 2026-04-09 17:53:11 +08:00
extensibility docs: fix documentation deviations from source code (#220) 2026-04-09 17:53:11 +08:00
features docs: 更新私有部署文档 2026-04-09 22:03:54 +08:00
images docs: 更新文档, 加上配图 2026-04-01 11:14:20 +08:00
internals docs: 添加文档 2026-04-03 11:52:14 +08:00
introduction docs: 文档优化完成 2026-04-01 17:18:48 +08:00
logo docs: 尝试修复 docs 的位置 2026-04-01 10:09:00 +08:00
plans 分离OpenAI和Anthropic模型的环境变量 2026-04-05 03:31:06 +08:00
safety 完善沙箱文档 (#195) 2026-04-08 16:49:24 +08:00
test-plans docs: 完成新版测试文档 2026-04-02 17:37:06 +08:00
tools feat: 修正 web search 工具 2026-04-03 00:47:37 +08:00
auto-updater.md feat: 关闭自动更新 2026-04-03 09:39:32 +08:00
external-dependencies.md feat: 添加 测试 agent 及一些文档 2026-04-03 19:27:23 +08:00
favicon.svg docs: 尝试修复 docs 的位置 2026-04-01 10:09:00 +08:00
feature-exploration-plan.md docs: 添加一大堆 feature 的描述 2026-04-02 22:52:32 +08:00
feature-flags-audit-complete.md feat: enable SHOT_STATS, PROMPT_CACHE_BREAK_DETECTION, TOKEN_BUDGET feature flags 2026-04-05 21:07:38 +08:00
lsp-integration.md docs: 调整文档 2026-04-03 19:56:35 +08:00
openai-task-tools.md Fix bug OpenAI tooluse,Improve error messaging for deferred-loading tools under OpenAI‑compatible models. (#199) 2026-04-08 18:08:59 +08:00
projects-collection.md docs: 更新文档 2026-04-03 20:23:51 +08:00
REVISION-PLAN.md docs: 完成大量文档 2026-04-01 14:44:21 +08:00
telemetry-remote-config-audit.md feat: 关闭 Datadog 日志发送 2026-04-03 09:49:59 +08:00
testing-spec.md test: 新增一波测试文件 2026-04-02 16:21:24 +08:00
ultraplan-implementation.md docs: 添加一大堆 feature 的描述 2026-04-02 22:52:32 +08:00