⚡

Claude代码代理创建与维护 claude-code-agents

这个技能用于创建和维护AI驱动的Claude代码代理，支持YAML前端定义、最小权限工具选择、委托模式和安全实践。关键词：Claude代码代理，AI智能体，YAML，最小权限，委托模式，安全性，SEO优化。

AI智能体 0 次安装 0 次浏览 更新于 3/7/2026

name: claude-code-agents description: 创建和维护Claude代码代理/子代理（.claude/agents/*.md），包含YAML前端（name/description/tools/model/permissionMode/skills/hooks）、最小权限工具选择、委托模式（Task）、上下文预算和安全最佳实践。

Claude代码代理

创建和维护Claude代码代理/子代理，使其具有可预测的行为、最小权限工具和明确的委托合同。

快速开始

  1. 在.claude/agents/<代理名称>.md处创建代理文件（kebab-case文件名）。
  2. 添加YAML前端（必需：name、description；可选：tools、model、permissionMode、skills、hooks）。
  3. 编写代理提示：职责、工作流程和输出合同。
  4. 最小化工具：从只读开始，然后仅添加代理真正需要的内容。
  5. 在实际任务上测试并迭代。

最小模板：

---
name: sql-optimizer
description: 优化SQL查询、解释权衡、并提出安全索引建议
tools: Read, Grep, Glob
model: sonnet
---

# SQL优化器

## 职责
- 在可用时使用查询形状和计划诊断瓶颈
- 提出优化建议，包括风险和预期影响

## 工作流程
1. 识别慢路径和数据量假设
2. 提出更改（查询重写、索引、统计）并附上理由
3. 提供验证计划

## 输出合同
- 摘要（1-3点）
- 建议（排序）
- 验证（运行命令/测试）

工作流程（2026）

  1. 定义代理的范围和成功标准。
  2. 根据风险、延迟和成本选择模型（大多数工作默认使用sonnet）。
  3. 通过最小权限选择工具；除非必需，避免授予Edit/Write权限。
  4. 如果使用Task委托，定义交接合同（输入、约束、输出格式）。
  5. 为破坏性操作和秘密添加安全栏杆。
  6. 添加验证步骤（检查清单、测试或专用验证器代理）。

前端字段（摘要）

  • name（必需）：kebab-case；匹配文件名（不带.md）。
  • description（必需）：说明何时调用及做什么；包含用户可能说的关键词。
  • tools（可选）：显式允许列表；首选小型、专用的集合。
  • model（可选）：haiku用于快速检查，sonnet用于大多数任务，opus用于高风险推理，inherit以匹配父级。
  • permissionMode（可选）：首选默认值；仅在明确理由且理解权衡后更改。
  • skills（可选）：为领域专业知识预加载技能包；保持列表最小。
  • hooks（可选）：自动化护栏；首选使用hooks技能处理模式和安全。

有关完整工具语义和权限模式，请使用references/agent-tools.md。有关编排和反模式，请使用references/agent-patterns.md。

2026最佳实践（领域专业知识）

  • 使用小型、专门的代理；避免“万能代理”。
  • 保持代理提示简短；将仓库约定放在CLAUDE.md/项目内存中，领域知识放在技能中。
  • 预算上下文：传递文件路径、最小片段和约束；避免转储长日志/代码。
  • 用于代理的显式交接：“目标/约束/输入/输出合同”。
  • 为风险更改（安全、迁移、基础设施、认证）添加验证步骤。
  • 将CLI字段/功能视为动态；根据data/sources.json中的官方文档验证。

验证检查清单

  • 前端：name匹配文件名；description为单行且面向触发；工具最小化；模型适合风险。
  • 提示：职责具体；工作流程可操作；输出合同明确。
  • 委托：子代理简报具体且有界；编排器验证集成。
  • 安全：确认破坏性操作；避免秘密/个人识别信息；遵循仓库政策。

导航

  • frameworks/shared-skills/skills/claude-code-agents/references/agent-patterns.md
  • frameworks/shared-skills/skills/claude-code-agents/references/agent-tools.md
  • frameworks/shared-skills/skills/claude-code-agents/data/sources.json
  • frameworks/shared-skills/skills/claude-code-skills/SKILL.md
  • frameworks/shared-skills/skills/claude-code-commands/SKILL.md
  • frameworks/shared-skills/skills/claude-code-hooks/SKILL.md