Claude Code Toolkit开发者指南如何贡献你的第一个Agent、Skill或插件附模板【免费下载链接】awesome-claude-code-toolkitThe most comprehensive toolkit for Claude Code -- 135 agents, 35 curated skills, 42 commands, 176 plugins, 20 hooks, 15 rules, 7 templates, 14 MCP configs, 26 companion apps, 52 ecosystem entries, and more.项目地址: https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkitClaude Code Toolkit 是目前最全面的 Claude Code 工具箱收录了 135 个 Agent、35 个精选 Skill、42 个命令、176 插件和 20 个 Hooks。想为它贡献你的第一个 Agent、Skill 或插件吗这篇开发者指南将带你从零走通完整流程理解项目结构、套用现成模板、遵守命名规范最后提交 Pull Request。整个过程不需要写复杂代码——核心内容都是 Markdown 文件对新手非常友好。为什么选择 Claude Code Toolkit 作为贡献起点这个项目有几个对新手特别友好的特点内容即文档Agent 和 Skill 本质上是结构化的 Markdown写好提示词就等于完成了大部分工作模板现成仓库里有大量可直接参考的实例照着写即可贡献规范清晰官方在 CONTRIBUTING.md 中明确列出了提交流程和命名规则项目五大内容类型速览类型存放目录文件格式上手难度Agentagents/分类/单个 Markdown⭐ 最简单Commandcommands/分类/单个 Markdown⭐Skillskills/技能名/SKILL.md⭐⭐Pluginplugins/插件名/目录 清单文件⭐⭐Hookhooks/scripts/脚本 JSON 配置⭐⭐⭐建议新手按Agent → Command → Skill → Plugin的顺序逐级挑战。快速准备3步搭建本地环境第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkit第 2 步创建功能分支按官方约定使用feature/前缀git checkout -b feature/your-feature第 3 步本地验证把新内容放入对应目录用 Claude Code 加载测试。Hook 和插件类贡献必须在提交前完成本地测试这也是官方贡献守则的硬性要求。贡献你的第一个Agent附完整模板Agent 是 Claude Code Toolkit 中最轻量的贡献单元存放于agents/下的分类目录中如 agents/core-development/、agents/quality-assurance/ 等 11 个分类。Agent 文件结构模板以仓库中的 code-reviewer.md 为参考范本一个标准 Agent 文件由两部分组成1. YAML 前置元信息Frontmatter--- name: your-agent-name description: 一句话说明这个Agent解决什么问题 tools: [Read, Write, Edit, Bash] model: opus ---2. 角色提示词正文通常包含角色设定一句话说清你是谁如你是一名资深工程师负责代码评审工作流程编号步骤如先理解上下文、再检查正确性、最后评估设计关注清单分维度列出具体检查项输出风格约定反馈的语气与格式Agent 命名规范官方要求使用kebab-case.md格式例如code-reviewer.md、ai-engineer.md见 agents/ 目录下的 135 个实例。贡献你的第一个SkillSKILL.md写作模板Skill 是教 Claude Code 掌握方法论的模块存放在skills/技能名/目录中核心文件为SKILL.md。仓库收录了 35 个精选 Skill如 skills/tdd-mastery/、skills/security-hardening/。SKILL.md 标准写法参考 skills/manage-skills/SKILL.md 与 skills/tdd-mastery/SKILL.md结构如下--- name: skill-name description: 简要描述这个Skill的作用 --- # Skill 名称 ## 核心方法论 - 分步骤说明工作流程如 Red-Green-Refactor 三阶段 ## 实践模式 - 附上各语言的典型示例 ## 常见陷阱 - 列出反模式与规避建议写作要点目录名即技能名必须使用kebab-case如tdd-masterydescription 要具体它决定 Claude Code 何时自动调用该 Skill可加示例文件目录下可放可选的 examples 辅助说明一个绝佳的参考范本想写测试类 Skill直接精读 skills/tdd-mastery/SKILL.md——它用红-绿-重构循环组织全文每个阶段都有可执行的动作清单是 Skill 写作的教科书级范例。贡献你的第一个插件最小目录结构插件是功能最完整的扩展单元一个插件可以打包多个命令。以仓库内的 plugins/a11y-audit/ 为例最小结构只有 3 个文件plugins/a11y-audit/ ├── .claude-plugin/ │ └── plugin.json ← 插件清单必需 └── commands/ ├── run-audit.md ← 斜杠命令1 └── generate-report.md ← 斜杠命令2plugin.json 清单模板参考 plugin.json字段非常简洁{ name: a11y-audit, version: 1.0.0, description: Full accessibility audit with WCAG compliance checking, commands: [commands/run-audit.md, commands/generate-report.md] }其中commands字段列出该插件提供的所有命令文件命令文件本身与 commands/ 目录中的独立命令写法一致纯 Markdown 流程描述。贡献流程从分支到Pull Request的7步官方在 CONTRIBUTING.md 中定义了标准流程Fork 仓库创建功能分支git checkout -b feature/your-feature完成你的修改在本地测试变更用清晰的提交信息提交如git commit -m Add new-skill: description推送到你的 Fork发起 Pull Request 小提示提交信息建议采用类型: 说明格式一眼就能看出你加了什么。贡献检查清单一条PR快速通过的6个要点提交前对照这份清单自查全部来自官方贡献守则✅单一职责每个文件只做一件事内容聚焦✅命名清晰Agent/Command/Skill/Rule 一律使用kebab-case✅删除废话注释显而易见或重复的代码注释要删掉✅本地测试通过插件和 Hook 必须实测后再提交✅更新 README 表格新增条目后记得同步 README 中对应分类的列表✅不生成署名页脚文件中不要出现自动生成的归属声明总结你的贡献路线图现在你已经掌握了 Claude Code Toolkit 贡献的完整地图阶段目标参考模板第一周提交一个 Commandcommands/testing/tdd.md第二周提交一个 Agentcode-reviewer.md第三周提交一个 Skilltdd-mastery/SKILL.md进阶打包一个 Pluginplugins/a11y-audit/记住两个关键原则文件单一职责、本地充分测试。从最小的 Command 开始练手逐步挑战 Skill 和 Plugin你的第一个 Agent、Skill 或插件离合并已经很近了。【免费下载链接】awesome-claude-code-toolkitThe most comprehensive toolkit for Claude Code -- 135 agents, 35 curated skills, 42 commands, 176 plugins, 20 hooks, 15 rules, 7 templates, 14 MCP configs, 26 companion apps, 52 ecosystem entries, and more.项目地址: https://gitcode.com/gh_mirrors/aw/awesome-claude-code-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考