Feature Request: Document sub-agent hook inheritance semantics

R2: 子 Agent Hook 继承性架构修复 — Feature Request

状态: 待向 CC 团队提交 日期: 2026-06-30 目标: 请求 CC 官方文档明确声明子 agent hook 继承语义

问题描述

CC 官档未明确声明子 agent（通过 Agent 工具 spawn 或 Workflow agent() 创建）是否继承主会话的 hook 配置。

实测发现：

• SubagentStart/SubagentStop 事件专用于子 agent — 说明部分 hook 事件被子 agent 触发
• PreToolUse/PostToolUse 事件是否被子 agent 继承 → 文档未说明
• 社区有零星讨论但无官方确认

这会影响到：

1. 安全防线设计 — 如果子 agent 不继承 PreToolUse hook，意味着 spawn 出去的 agent 完全绕开主会话的安全守卫
2. subagent-guard.sh 通过 SubagentStart 注入 CTX 约束 — 这是当前唯一的防线 — 但如果 PreToolUse hook 被继承，那就是双重防线
3. 合规要求 — 需要知道哪些防线在子 agent 中有效，否则可能在不知情下漏防

请求

请：

1. 在官方 docs 中明确声明：哪些 hook 事件被子 agent 继承、哪些不继承
2. 如果 PreToolUse/PostToolUse 不继承，请在文档中标注为已知局限
3. 考虑加 "inheritInSubagents": true/false 配置项让用户自行控制

优先级

P1 — 安全防线设计的根基信息缺失，所有子 agent 安全策略建立在一个不确定的前提上。