构建者代理指南

---
# 官方字段
name: my-custom-skill # 技能标识符 (kebab-case,最多 64 字符)
description: > # 目的说明 (50~1024 字,第三人称)
  自定义技能的说明。描述用于什么任务,提供什么专业知识,
  以第三人称撰写。
allowed-tools: # 允许的工具 (逗号分隔或列表)
  - Read
  - Grep
  - Glob
model: claude-sonnet-4-20250514 # 使用的模型 (省略时为当前模型)
context: fork # 在子代理上下文中执行
agent: general-purpose # context: fork 时使用的代理
hooks: # 技能生命周期钩子
  PreToolUse: ...
user-invocable: true # 斜杠命令菜单显示
disable-model-invocation: false # false 时 Claude 也可以直接调用
argument-hint: "[issue-number]" # 自动补全提示
 
# MoAI-ADK 扩展字段
version: 1.0.0 # 语义版本 (MAJOR.MINOR.PATCH)
category: domain # 8 个类别之一
modularized: false # 是否使用 modules/ 目录
status: active # active | experimental | deprecated
updated: "2025-01-28" # 最后修改日期
tags: # 用于发现的标签数组
  - graphql
  - api
related-skills: # 关联技能
  - moai-domain-backend
  - moai-lang-typescript
context7-libraries: # MCP Context7 库 ID
  - graphql
aliases: # 别名
  - graphql-expert
author: YourName # 作者
---

.claude/skills/my-skills/
└── my-graphql-patterns/
    ├── SKILL.md            # 主技能文档 (500 行以下)
    ├── modules/            # 深度文档 (无限制)
    │   ├── schema-design.md
    │   └── resolver-patterns.md
    ├── examples.md         # 实战示例
    └── reference.md        # 外部参考

---
# YAML
---
 
# 项目信息
 
项目名称: !basename $(pwd) Git 分支: !git branch --show-current

# Claude Code 中调用 builder-skill
> 创建一个 GraphQL API 设计模式的自定义技能

---
name: my-graphql-patterns
description: >
  GraphQL API 设计专家。提供模式设计、解析器模式、N+1 问题解决、DataLoader
  模式。GraphQL API 开发时使用。
version: 1.0.0
category: domain
status: active
triggers:
  keywords: ["graphql", "schema", "resolver", "dataloader"]
  agents: ["expert-backend"]
allowed-tools: ["Read", "Grep", "Glob"]
---
 
# GraphQL API 设计专家
 
## Quick Reference
 
- 模式优先设计 (Schema-First)
- 为防止 N+1 问题必须使用 DataLoader
- 分页使用 Relay Cursor 方式
 
## Implementation Guide
 
(详细实现指南)
 
## Advanced Patterns
 
(高级模式)
 
## Works Well With
 
- moai-domain-backend
- moai-lang-typescript

---
name: my-data-analyst
description: >
  数据分析专家。负责数据管道设计、ETL 流程、分析查询优化。
  PROACTIVELY 用于数据分析任务时自动委托。
tools: Read, Write, Edit, Grep, Glob, Bash, TodoWrite
disallowedTools: Task, Skill # 可选:排除的工具
model: sonnet # sonnet | opus | haiku | inherit
permissionMode: default # 权限模式
skills: # 预加载的技能
  - moai-lang-python
  - moai-domain-database
hooks: # 代理生命周期钩子
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "echo 'File modified'"
---
 
你是数据分析专家。
 
## Primary Mission
 
通过数据管道设计和实现提供数据驱动的洞察。
 
## Core Capabilities
 
- 数据管道设计和实现
- ETL 流程自动化
- 分析查询优化
- 数据可视化
 
## Scope Boundaries
 
IN SCOPE:
 
- 数据分析和可视化
- ETL 流程设计
- 查询性能优化
 
OUT OF SCOPE:
 
- ML 模型开发 (委托给 expert-data-science)
- 基础设施配置 (委托给 expert-devops)
 
## Delegation Protocol
 
- 需要 ML 模型时: expert-data-science
- 基础设施设置时: expert-devops
 
## Quality Standards
 
- TRUST 5 框架合规
- 数据完整性验证
- 查询性能优化

my-plugin/
├── .claude-plugin/
│   └── plugin.json         # 插件清单
├── commands/               # 斜杠命令 (根级别!)
│   └── analyze.md
├── agents/                 # 代理定义 (根级别!)
│   └── data-expert.md
├── skills/                 # 技能定义 (根级别!)
│   └── my-skill/
│       └── SKILL.md
├── hooks/                  # Hooks 设置 (根级别!)
│   └── hooks.json
├── .mcp.json               # MCP 服务器设置
├── .lsp.json               # LSP 服务器设置
├── LICENSE
├── CHANGELOG.md
└── README.md

{
  "name": "my-data-plugin",
  "version": "1.0.0",
  "description": "数据分析任务的综合插件",
  "author": {
    "name": "My Team",
    "email": "[email protected]",
    "url": "https://example.com"
  },
  "homepage": "https://example.com/docs",
  "repository": {
    "type": "git",
    "url": "https://github.com/owner/repo"
  },
  "license": "MIT",
  "keywords": ["data", "analytics", "etl"],
  "commands": ["./commands/"],
  "agents": ["./agents/"],
  "skills": ["./skills/"],
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "lspServers": "./.lsp.json",
  "outputStyles": "./output-styles/"
}

{
  "name": "my-marketplace",
  "owner": {
    "name": "My Organization",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "plugin-one",
      "source": "./plugins/plugin-one"
    },
    {
      "name": "plugin-two",
      "source": {
        "type": "github",
        "repo": "owner/repo"
      }
    }
  ]
}

# 从 GitHub 安装插件
$ /plugin install owner/repo
 
# 本地插件验证
$ /plugin validate .
 
# 激活插件
$ /plugin enable my-data-plugin
 
# 添加 Marketplace
$ /plugin marketplace add ./path/to/marketplace
 
# 列出已安装的插件
$ /plugin list

# 插件创建请求
> 创建一个数据分析插件。
> 包含技能、代理、命令。

# 技能创建
> @"builder-skill (agent)" 创建 GraphQL 模式的自定义技能
 
# 代理创建
> @"builder-agent (agent)" 创建数据分析专家代理
 
# 插件创建
> @"builder-plugin (agent)" 创建数据分析综合插件