AI 技能/插件人工智能【免费下载链接】awesome-claude-code-subagentsA collection of 100 specialized Claude Code subagents covering a wide range of development use cases项目地址https://gitcode.com/gh_mirrors/aw/awesome-claude-code-subagents点击查看免费下载这篇指南面向希望向 awesome-claude-code-subagents 仓库提交 Claude Code 子代理Subagent或工具的开发者完整梳理 CONTRIBUTING.md 中定义的贡献流程从新 Subagent 的分类选择、必改文件清单到插件版本同步机制与工具Skill的目录规范。读完本文你将掌握一套可复用的贡献检查清单能够按仓库既有模板高质量地提交 PR并理解插件版本plugin.json / marketplace.json如何驱动claude plugin update向用户推送更新。一、贡献前先理解仓库的组织结构在动手提交之前先明确仓库的物理布局这直接决定了该把文件放哪里、该改哪些文件categories/全部 Subagent 按主题分为 10 个编号分类目录如01-core-development、02-language-specialists、03-infrastructure每个分类下既有各 agent 的.md定义文件也有分类自己的README.md和.claude-plugin/plugin.jsontools/可选的 Claude Code Skill 目录目前内置了 subagent-catalog一个用于浏览、检索、拉取 Subagent 定义的命令集合其内部是README.md 命令文件带 YAML frontmatterconfig.sh共享脚本的结构根目录文件主 README.md分类索引与安装说明、CLAUDE.md、install-agents.sh交互式安装脚本、.claude-plugin/marketplace.json市场插件清单。CONTRIBUTING.md 的核心逻辑正是围绕新增 Subagent更新插件版本新增工具三条主线的文件变更约束展开。二、如何新增一个 Subagent四步主流程CONTRIBUTING.md 规定新增 Subagent 需按以下顺序执行选择正确的分类Choose the right category——将你的 Subagent 放入最贴切的分类文件夹。例如一个语言专精型 agent 应进入categories/02-language-specialists/基础设施类进入categories/03-infrastructure/测试你的 SubagentTest your subagent——确保它能与 Claude Code 正常工作即 frontmatter 中的name、description、tools、model合法系统提示词逻辑自洽更新必需文件Update required files——同时维护主 README、分类 README、agent 定义文件三处详见下节提交 PRSubmit a PR——附带清晰的用途说明。主 README 的贡献入口README.md也印证了这三类可接受贡献通过 PR 提交新 Subagent、改进既有定义、报告问题。三、每个 Subagent 必须包含的七要素CONTRIBUTING.md 要求每个 Subagent 定义至少覆盖清晰的角色定义Clear role definition专长领域清单List of expertise areas所需的 MCP 工具Required MCP tools, if any通信协议示例Communication protocol examples核心能力Core capabilities示例使用场景Example usage scenarios最佳实践Best practices以仓库现成的 python-pro 为范本可以直观看到这七要素如何落到实际文件frontmatter角色与激活条件name: python-pro、description写明构建类型安全的生产级 Python 代码时调用本 agent、tools: Read, Write, Edit, Bash, Glob, Grep、model: sonnet角色定义正文首段即声明senior Python developer掌握 Python 3.11 生态专长清单后续分段覆盖类型系统TypeVar/ParamSpec/Protocol/TypedDict、异步并发AsyncIO/concurrent.futures、Web 框架FastAPI/Django/SQLAlchemy/Pydantic、数据科学、性能优化、安全最佳实践等通信协议示例文件中的Communication Protocol章节给出了标准 JSON 交互样例如request_type: get_python_context便于多 agent 协作时解析示例使用场景与最佳实践Development Workflow章节按 Codebase Analysis → Implementation → Quality Assurance 三阶段展开并附状态上报 JSON 示例与质量检查清单。新贡献者可以完全复刻这一文件结构替换为自身领域的角色、专长与协议内容。四、添加新 Agent 时 MUST 更新的三处文件CONTRIBUTING.md 用MUST强调了三处联动更新缺一不可1. 主 README.md在主 README 对应分类小节中按字母序加入 agent 链接格式为- **agent-name** - Brief description例如 README 中语言分类的条目写法见 README.md- [**typescript-pro**](https://link.gitcode.com/i/f5ec9bc407bffb494cec7706835c4f88) - TypeScript specialist2. 分类 README.md如categories/02-language-specialists/README.md分类 README 是一个独立成篇的导航文档需同步更新Available Subagents小节追加详细描述角色简介 Use when 使用时机Quick Selection Guide表格在语言/框架 → Subagent → 适用场景的映射表中插入新行若适用更新Common Technology Stacks小节如把新 agent 组合进Modern Web Application / Mobile Development / Enterprise Backend等推荐技术栈组合。以 02-language-specialists/README.md 为例其 Quick Selection Guide 的每一行都保持| 语言/框架 | **agent-name** | 最佳适用场景 |的统一格式新条目必须维持同样对齐与风格避免破坏表格可读性。3. 你的 Agent 文件如categories/02-language-specialists/your-agent.md遵循标准模板结构见下节模板结构包含全部必需章节且 frontmatter 与 README 中的描述保持口径一致。五、Agent 文件的标准模板结构CONTRIBUTING.md 依赖仓库 README 中定义的标准化模板README.md新 agent 应严格对齐--- name: subagent-name description: When this agent should be invoked tools: Read, Write, Edit, Bash, Glob, Grep model: sonnet --- You are a [role description and expertise areas]... [Agent-specific checklists, patterns, and guidelines]... ## Communication Protocol Inter-agent communication specifications... ## Development Workflow Structured implementation phases...两个影响实际运行的关键字段值得注意model智能模型路由决定该 agent 默认由哪个 Claude 模型处理——opus用于深度推理如架构评审、安全审计、sonnet用于日常编码、haiku用于快速任务也支持设model: inherit跟随主会话模型。贡献者可按任务复杂度合理选择tools最小权限原则只读型 agentreviewers/auditors建议Read, Grep, Glob研究型 agent 追加WebFetch, WebSearch代码编写型 agent 使用Read, Write, Edit, Bash, Glob, Grep。每个 agent 只声明完成任务所需的最小工具集需要时可再扩展 MCP 服务。六、插件更新时的版本管理要求这是 CONTRIBUTING.md 中最容易被忽略、却直接影响用户体验的规则任何categories/category下*.md文件变更后必须同步 bump 版本否则用户通过claude plugin update无法收到更新。1. 提升分类插件版本修改categories/category/.claude-plugin/plugin.json中的version字段。以语言分类为实例categories/02-language-specialists/.claude-plugin/plugin.json{ name: voltagent-lang, version: 1.0.4, description: Language-specific expert agents with deep framework knowledge - Python, TypeScript, Go, Rust, Java, and more, license: MIT, agents: [ ./angular-architect.md, ./cpp-pro.md, ... ] }注意agents数组必须一一列出该分类下的全部 agent 文件新增 agent 时同时要在数组中追加对应条目这是 CLAUDE 插件加载 agent 清单的依据。2. 保持市场插件版本同步修改根目录.claude-plugin/marketplace.json将对应 plugin 条目的version更新为与分类插件一致的版本号。该文件的每个 plugin 条目均包含name、source指向分类目录的相对路径、description、version、category与keywords.claude-plugin/marketplace.json。例如{ name: voltagent-lang, source: ./categories/02-language-specialists, description: Language-specific expert agents with deep framework knowledge - Python, TypeScript, Go, Rust, Java, and more, version: 1.0.4, category: development, keywords: [python, typescript, golang, rust, java, ...] }两处版本号必须保持完全一致否则claude plugin update的版本比对会失效。这属于版本管理的双写约束PR 自检时应重点核对。七、如何添加一个 ToolClaude Code SkillTools 是增强目录体验的 Claude Code Skills发现、浏览、管理 Subagent与 agent 文件是两条独立的贡献线。CONTRIBUTING.md 规定在tools/下创建以工具名命名的文件夹包含必需文件README.md——安装与使用文档命令文件.md——每个命令一个文件带 YAML frontmatter含name与description辅助脚本.sh、.py——需要共享工具函数时的公共脚本遵循 Skill 最佳实践frontmatter 中的name/description要有描述性description中写入触发短语错误处理要友好更新主 README在 Tools 小节添加工具条目提交前本地测试。仓库自带的 tools/subagent-catalog 是这一规范的最佳样例目录结构README.mdsearch.md、fetch.md、list.md、invalidate.md四个命令文件 config.sh共享脚本命令文件带 YAML frontmatter如 search.md 开头--- name: search description: Search the awesome-claude-code-subagents catalog. Use when user wants to find, discover, or browse available subagents by name, category, or capability. ---共享脚本 config.sh 集中管理配置12 小时缓存 TTL、缓存文件路径、GitHub raw URL并提供subagent_catalog_ensure_cache等函数被各命令文件source复用——这正是辅助脚本共享工具函数的落地方式错误处理fetch.md中给出了not found → 建议先 searchmultiple matches → 列出让用户指定network error → 检查网络重试的分支表符合以用户友好信息处理错误的要求。八、行为准则与 PR 流程行为准则Code of ConductCONTRIBUTING.md 明确要求贡献者保持尊重与包容、提供建设性反馈、提交前测试贡献、遵循现有格式与结构。这也是主 README 中不接受以推广产品/公司为主要目的的 PR、Subagent 必须对 Claude Code 用户真正有用且保持厂商中立README.md一以贯之的社区基调。Pull Request 流程Fork 仓库并克隆到本地git clone https://gitcode.com/gh_mirrors/aw/awesome-claude-code-subagents创建功能分支git checkout -b feature/new-subagent按模板添加 Subagent更新所有必需位置主 README分类小节、字母序、分类 README描述、表格校验所有链接可正确解析仓库是只读的提交前请自行检查相对路径提交 PR 并附清晰描述说明该 Subagent 的用途。质量指南Quality GuidelinesCONTRIBUTING.md 的验收底线可浓缩为四句话Subagent 应结构良好且经过测试包含清晰的文档提供实用的示例确保与 Claude Code 的兼容性。建议在 PR 描述中直接列出选择的分类、更新了哪三处文件、plugin.json 与 marketplace.json 的版本号、以及本地测试结论。九、许可证与贡献者的注意事项CONTRIBUTING.md 末尾明确MIT License贡献即表示同意你的贡献以 MIT 许可发布免责声明仓库中所有 Subagent 均按as is提供、不附带任何担保维护者不审计、不保证任何贡献的安全性与正确性也不对使用引发的问题承担责任。这意味着贡献者有义务对自身提交的 agent 定义负责使用者也应在接入生产环境前自行审查。这一立场同样写在主 README.md 与 LICENSE 中。十、一份可复用的贡献检查清单综合上述规范提交一个完整 PR 前请逐项核对分类选择正确categories/编号-主题/Agent 文件包含七要素角色、专长、MCP 工具、通信协议、核心能力、使用场景、最佳实践frontmatter 四字段齐全name、description、tools、model主 README 分类小节已按字母序添加链接分类 README 的 Available Subagents、Quick Selection Guide、Common Technology Stacks 已同步categories/分类/.claude-plugin/plugin.json的version已 bump且agents数组包含新文件.claude-plugin/marketplace.json对应条目版本与分类插件一致若新增 Tooltools/下目录、README.md、命令文件带 frontmatter、共享脚本齐备并已更新主 README 的 Tools 小节本地用 Claude Code 实测通过全部链接解析正常分支名规范、PR 描述清晰遵循这份清单你的贡献将能无缝融入 158 Subagent 的目录体系并被插件更新通道claude plugin update正确推送给所有用户。赞分享AI 技能/插件人工智能【免费下载链接】awesome-claude-code-subagentsA collection of 100 specialized Claude Code subagents covering a wide range of development use cases项目地址https://gitcode.com/gh_mirrors/aw/awesome-claude-code-subagents点击查看免费下载相关推荐为 Awesome Claude Skills 贡献高质量 Claude Skill完整贡献指南与实践规范为 Awesome Claude Skills 贡献高质量 Claude Skill完整贡献指南与实践规范 本指南基于 Awesome Claude SkilAI 技能AI 插件人工智能工作流自动化从用户到贡献者Awesome Claude Code社区贡献完全指南从用户到贡献者Awesome Claude Code社区贡献完全指南 你是否曾想为开源社区贡献力量却不知从何入手是否担心复杂的Git操作会成为参与的障碍文档知识库YouTube.js 中的 VideoDetails 类InnerTube 视频元数据解析与实战使用指南YouTube.js 中的 VideoDetails 类InnerTube 视频元数据解析与实战使用指南 导读 VideoDetails 是 YouTube.AI 技能/插件人工智能上一篇脆皮豆腐食谱全解析从 RAG 知识库语料看数据准备与结构分块实战下一篇Switch游戏文件终极管理指南NSC_BUILDER如何帮你轻松应对NSP、XCI、NSZ、XCZ格式转换创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考