用途：在 agent-almanac 库中新增一个 Claude Code 子代理（subagent）定义文件，把重复出现的工作流或提示模式固化为可复用的代理角色，或把过宽的代理拆分为单一职责的代理。
主要能力：按模板生成代理文件并填写 YAML frontmatter（name、description、tools、model、version、author 等）；设计角色定位与沟通风格；按最小权限原则选择工具集（如只读分析用 [Read, Grep, Glob]，开发用 [Read, Write, Edit, Bash, Grep, Glob]）；选择模型（默认 sonnet，可选 opus、haiku）；从 skills/_registry.yml 分配 3-15 个技能；编写 Purpose、Capabilities、Available Skills、Usage Scenarios、Examples、Limitations、See Also 等章节；在 agents/_registry.yml 中按字母序登记并更新 total_agents；验证 .claude/agents/ 符号链接可发现；为 de、zh-CN、ja、es 四种语言生成翻译脚手架。
使用方式：先检查是否与现有代理重叠，例如 grep -i "description:" agents/_registry.yml | grep -i "<your-domain-keywords>"；复制模板 cp agents/_template.md agents/<agent-name>.md；填写 frontmatter 与正文；登记注册表；运行 npm run update-readmes；再执行 for locale in de zh-CN ja es; do npm run translate:scaffold -- agents <agent-name> "$locale"; done，最后运行 npm run translation:status。
适用场景：为尚未覆盖的领域新增专家代理、把重复工作流转为可复用角色、创建带受限工具的领域助手、拆分过宽代理、在组建多代理团队前设计成员。
限制：代理名称须为小写 kebab-case；技能 ID 必须存在于 skills/_registry.yml；默认技能 meditate、heal 由注册表继承，除非是核心方法否则不要列出；需避免与现有 72 个代理功能重叠；翻译脚手架为必需步骤，不可跳过。具体收费、价格与平台支持情况暂未提供。