agent-development

核心用法

agent-development 是一个纯文档型技能，专注于指导用户设计和构建 Claude Code 自定义 Agent。其核心用法包括：

1. Agent 描述设计：使用 "MUST BE USED when..." 和 "Use PROACTIVELY for..." 等强触发模式，确保 Claude 能自动识别并委托任务给子 Agent。

2. 工具权限最小化：遵循"不需要 Bash 就不给 Bash"原则，根据 Agent 职责精确分配工具集（如只读审计型 Agent 仅授予 Read/Glob/Grep），避免权限滥用和频繁的命令行审批干扰。

3. 模型选择策略：Opus 用于创意工作（页面构建、设计），Sonnet 作为大多数 Agent 的默认选择，Haiku 仅用于质量不重要的脚本执行。

4. 内存管理配置：通过设置 NODE_OPTIONS="--max-old-space-size=16384" 将 Node.js 堆内存从 4GB 提升至 16GB，解决大规模并行 Agent 的内存崩溃问题。

5. 声明式提示设计：描述"做什么"而非"怎么做"，避免在提示中硬编码具体工具调用命令，让模型自主决定最佳执行路径。

6. 流水线 Agent 编排：设计可并行执行的 Agent 工作流，每个 Agent 处理独立任务项，通过结构化报告返回结果，由人工审查后批量提交。

显著优点

• 权威性极强：源自 Claude Code 官方生态系统，作者 Jeremy Dawes 为资深开发者，内容经过实战验证
• 系统性完整：覆盖 Agent 开发全生命周期，从描述设计、工具权限、模型选择到内存优化、流水线编排
• 实操性突出：提供大量可直接复制的 YAML 模板、配置代码和检查清单，降低落地门槛
• 安全导向明确：强调最小权限原则，提供 Allowlist 配置模式，帮助用户在便利与安全间取得平衡
• 反模式警示：详细列举常见陷阱（如"As we discussed earlier..."等上下文依赖表述），加速开发者成长

潜在缺点与局限性

• 无自动化执行：纯文档型技能，所有配置需手动完成，无法一键部署 Agent 模板
• Claude Code 专属：最佳实践深度绑定 Claude Code 的 Task 工具机制，迁移到其他 Agent 框架需大幅调整
• 并行规模受限：即使优化内存，仍建议 Heavy Creative Agent 并行数控制在 1-2 个，大规模批处理场景存在瓶颈
• 版本依赖风险：部分配置（如 .claude/settings.json 格式）可能随 Claude Code 版本迭代而变化

适合的目标群体

• Claude Code 重度用户：希望从"单轮对话"进阶到"多 Agent 协作"的高级用户
• 平台/工具开发者：需要为团队构建标准化 Agent 工作流的工程负责人
• AI 应用架构师：设计复杂 Agent 管道（如代码审查、文档生成、批量数据处理）的系统设计者
• 效率极客：追求"重复性任务自动化+关键节点人工审查"工作模式的开发者

使用风险

• 配置误操作风险：文档中的环境变量和权限配置示例若被盲目复制，可能导致系统环境变更或过度授权
• 内存优化副作用：16GB 堆内存设置对低配置机器可能造成系统资源紧张
• Agent 描述过度优化：强触发词设计不当可能导致 Claude 过度委托，增加 token 消耗和响应延迟
• 流水线调试复杂度：并行 Agent 失败时，问题定位需人工介入检查多个独立执行上下文