返回目录 / Agent 编排
验证项目目录中的 Agent 定义是否加载
从初始化消息读取已加载 agent 名称,避免把存在于磁盘误判为运行时可用。
目标
确认项目级 `.claude/agents/` 配置对当前 cwd 和 setting_sources 可见。
步骤
- 将 agent 定义放入项目约定的
.claude/agents/,并为 SDK 设置正确cwd。 [fsagents] - 配置
ClaudeAgentOptions(setting_sources=["project"], cwd=...),通过ClaudeSDKClient发起一条无副作用探测请求。 [fsagents] - 检查 subtype 为
init的SystemMessage.data["agents"],兼容其中字符串或带name的对象。 [fsagents]
验证方式
初始化列表含预期 agent 名称,且最后收到 AssistantMessage 和 ResultMessage。
故障处理
若 agent 缺失,依次核对 `cwd`、目录名和 `setting_sources`;记录 init 数据以定位发现失败。
权限边界
前置条件
- Python 3.10+、claude-agent-sdk、可读取的项目目录及 Claude Code 认证。
权限边界
- 请求范围限定在测试目录;不要开放项目中未审阅的工具配置。
限制
仅验证加载与路由,不把项目配置中的指令视为可信;运行前审阅其工具权限。
固定上游来源
- 仓库
- anthropics/claude-agent-sdk-python
- 文件路径
- examples/filesystem_agents.py
- 固定提交
b6e9d12fe1cc98dde988ab7b7713c1feeee50c6c- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT