Agent 配置清单一、基础标识字段字段名类型必填说明namestring✅Agent 唯一标识符用于调用和路由descriptionstring✅Agent 用途描述告诉调用者何时使用此 agent二、提示词与工具配置字段名类型必填说明system_promptstring❌Agent 的系统提示词定义行为准则toolsstring[]❌允许使用的工具列表null或[*]表示全部允许disallowed_toolsstring[]❌禁止使用的工具列表三、模型与性能配置字段名类型必填说明modelstring❌模型覆盖如haiku,sonnet,inheriteffortstring | int❌努力程度low/medium/high或正整数temperaturenumber❌温度参数控制输出随机性top_pnumber❌Top-P 采样参数max_turnsint❌最大执行轮次必须 0四、权限配置字段名类型必填说明permission_modestring❌权限模式default/acceptEdits/bypassPermissions/plan/dontAskpermissionobject❌细粒度权限规则支持工具级别的 allow/deny/askpermissionsstring[]❌额外权限规则列表Python 特有五、技能与扩展配置字段名类型必填说明skillsstring[]❌技能名称列表mcp_serversany[]❌MCP 服务器配置支持字符串引用或内联配置对象required_mcp_serversstring[]❌必须可用的 MCP 服务器模式列表hooksobject❌会话级别的钩子配置六、UI 与显示配置字段名类型必填说明colorstring❌显示颜色red/green/blue/yellow/purple/orange/cyan/magenta/white/grayhiddenboolean❌是否隐藏不显示给用户七、生命周期配置字段名类型必填说明modestring❌运行模式primary/subagent/allbackgroundboolean❌是否作为后台任务运行initial_promptstring❌预置到第一个用户轮次的提示stepsint❌最大步骤数八、内存与隔离配置字段名类型必填说明memorystring❌内存作用域user/project/localisolationstring❌隔离模式worktree/remote九、元数据配置字段名类型必填说明variantstring❌变体标识nativeboolean❌是否为内置 agentfilenamestring❌原始文件名不含扩展名base_dirstring❌定义文件所在目录sourcestring❌来源builtin/user/pluginomit_claude_mdboolean❌是否跳过 CLAUDE.md 注入critical_system_reminderstring❌每轮重新注入的提醒消息subagent_typestring❌路由键Python 特有配置文件示例--- name: code-reviewer description: 代码审查专家用于审查 PR 和代码变更 tools: [Read, Grep, Glob, WebFetch] disallowed_tools: [Write, Edit, Bash] model: sonnet effort: high permission_mode: dontAsk skills: - code-review - security-audit mcp_servers: - github color: purple background: false memory: project omit_claude_md: false --- 你是一个专业的代码审查专家。你的职责是 1. 审查代码质量和可维护性 2. 识别潜在的安全漏洞 3. 检查是否符合编码规范 4. 提供改进建议 审查时请关注 - 代码逻辑正确性 - 错误处理完整性 - 性能优化机会 - 测试覆盖率权限规则示例permission:*:allow# 默认允许所有doom_loop:ask# 死循环检测时询问question:deny# 禁止提问read:*:allow*.env:ask# 环境变量文件需确认edit:*:deny# 默认禁止编辑src/**/*.ts:allow# 仅允许编辑 src 下的 ts 文件这份清单涵盖了 Agent 配置的所有核心字段可以直接用于设计你自己的 Agent 配置系统。