创建边界清楚的专门 Agent
定义角色、工具范围与交付标准,并验证一次委派任务。
扩展能力用途#
创建专门 Agent,把边界清楚的任务交给有固定职责的助手。
开始前#
选一个独立小任务,写清文件范围和交付标准。项目定义在 .claude/agents/,个人定义在 ~/.claude/agents/。Agent 不会自动隔离文件,也不是永久在线的独立机器。
第一次操作#
- 在项目中选择
@Agent,创建docs-reviewer。 - 保留默认模型,按当前界面设置必要工具范围,填写指令:
只审查指定 Markdown 文件,不修改、安装、提交或发布。
输出问题、文件位置和依据;列出未检查部分。
完成标准:覆盖本次文件清单,结论可回到原文核对。
- 保存后要求助手将文档检查委派给
docs-reviewer。 - 查看实际调用和报告,由主会话核对后再决定是否修复。
确认成功#
Agent 使用预期角色,报告有真实位置与证据,没有擅自修改文件。抽查一个发现和一个正常样本;收到总结不等于全部检查已完成。
常见问题#
- 找不到定义:检查项目、作用域和文件名。
- 工具不能用:核对工具配置及授权。
- 权限字段不懂:保留默认;SDK 的
permissionMode不使用聊天值ask/code。