gsscoder/claude-coding-agents：把软件开发流程拆成20+个专项Agent，用过就回不去

gsscoder/claude-coding-agents：把软件开发流程拆成20+个专项Agent，用过就回不去

Claude Code 的 Agent 系统允许你给 AI 配一群专项助手，而不是让一个通才从头做到尾——但大多数人装完 Agent 仓库就扔在那里，根本没搞清楚什么场景该叫谁。gsscoder/claude-coding-agents 干了件更实在的事：把软件开发全流程拆成 20+ 个专项 subagent，每个只干一件事，干到专家水平，并且把 subagent 的定义规范和 SKILL.md 写法也一并开源出来。

功能与原则

这个仓库做两件事：

Subagents（子代理）：每个是 Claude Code 的一个独立角色，专攻一个狭窄领域——bug-hunter 专门找 bug，rest-auditor 专门扫 REST 接口，complexity-pruner 专门砍过度设计。没有模糊地带，不跨职责边界。

Skills（技能包）：验证类 skill，专注质量门——dotnet-preflight 检查 .NET 分支能不能开 PR，react-preflight 检查 React 分支能不能合并。Skill 触发后只读不写，报告结果，不自己动手修。

作者的核心工程原则写得很坦白：Claude Code 生成的 agent 定义容易出现四个问题——YAML 头描述冗余、正文用粗体装饰、换行和句号太多导致 token 浪费、同一概念反复出现。这些问题会直接塞满你的上下文窗口，所以这个仓库的所有 agent 都经过手工精简，每个定义都只保留对模型有实际信号的指令。

认可度

GitHub 仓库（https://github.com/gsscoder/claude-coding-agents），最后 push 时间 2026 年 8 月 18 日，距今不到一周。作者披露该 repo 起源于个人工作流迭代：作者在 side project 里逐步积累了一堆 agent 定义，迭代过程中意识到”Claude Code 默认生成的 agent 头太冗余”，于是花时间逐个精简，最终形成这套可复用的规范。skills 子目录在 8 月 18 日刚更新，移除了 react-preflight skill 里对 Chrome MCP 的依赖，迭代活跃。

链接

GitHub：https://github.com/gsscoder/claude-coding-agents

原作者

GitHub 用户 gsscoder（用户名全小写），无公开姓名，repo 自述这是个人 side project 的提炼。MIT 许可证，可自由使用和修改。

介绍

Claude Code 的 subagent 机制是让模型在隔离上下文里扮演一个专项角色——比如专门分析代码结构的 forensics-analyst，专门做架构审查的 design-reviewer。好处是每个角色的 system prompt 可以极度定制，工具权限可以精确控制；坏处是大多数人不知道什么场景该叫哪个 agent。

这个仓库的作者踩过的坑是：Claude Code 自己生成的 agent 头信息量太少，但内容又太冗余——大量人类才需要的多余装饰（加粗、留白、句号结尾），对模型毫无信号，却占满了上下文。解决办法是逐个手工 review 每个 agent 定义，砍掉装饰、压缩冗余、精简 YAML 头。

同时他把 DevOps 质量门做成了可移植的 SKILL.md 格式——dotnet-preflight 检查 EF Core 迁移和本地数据库健康，react-preflight 检查依赖安装和构建成功率。这些 skill 不需要 agent 框架，用 scopy 工具同步到项目目录即可。

特点

• 20+ 专项 subagent，覆盖开发全流程：代码分析、forensics、逆向、命名规范审计、REST 接口审查、Bug 搜索、架构审查、特性规划、前端构建、测试设计、测试修复等
• Subagent 版本锁定：每个 agent 标注 commit hash（如 code-analyst v2.0 (5e1e102c)），安装的是精确版本，不是浮动的 latest
• Token 优化意识：所有 agent 定义经过手工 review，专治”上下文被 agent 头撑满”的痛点
• Skills 目录：verification 类 skill，专注质量门（dotnet-preflight、react-preflight、dotnet-warning-audit）
• 支持 scopy 同步：通过 @koder0x/scopy 工具把 agent 文件同步到项目或用户的 ~/.claude/agents/ 目录
• MIT 许可证：自由使用、修改、分发

使用方法

安装 agents：

# 克隆仓库
git clone https://github.com/gsscoder/claude-coding-agents.git
cd claude-coding-agents

# 方式一：用 scopy 工具同步（推荐）
npm install -g @koder0x/scopy@next
scopy source add cc-agents https://github.com/gsscoder/claude-coding-agents/agents
scopy dest add my-project /path/to/your/project/.claude/agents
scopy sync cc-agents/agents/implement my-project --force   # 同步所有 implement 类 agents

# 方式二：手动复制（纯 Markdown 文件）
cp ./agents/*.md ~/.claude/agents/

安装 skills：

# skills 目录需要手动复制
cp -r ./skills/. /path/to/project/.claude/skills/

使用方式：直接在 Claude Code 里叫名字，如：

Use the forensics-analyst subagent to reverse-engineer this module.
Run the dotnet-preflight skill to verify this branch is safe to PR.

使用场景与人群

适用场景：已经在用 Claude Code 做实际项目开发的团队和个人开发者，特别是：

• 大型代码库需要专项分析工具（forensics-analyst 逆向不熟悉的遗留代码、convention-auditor 检查命名规范漂移）
• 多 Agent 并行分工的工作流（feature-builder 派活、task-builder 做计划、test-builder 写测试）
• .NET / React 项目需要 CI 级质量门（dotnet-preflight、react-preflight）

目标用户：对 AI 辅助开发有一定使用经验，想从”一个通用 AI 写所有代码”升级到”专项 Agent 各司其职”的工程师。不适合 AI 编程纯新手——需要理解 subagent 的上下文隔离机制才能用好。

输入与输出案例

案例 1：找 Bug

输入："Use the bug-hunter agent to find concurrency bugs in the auth module"
输出：agent 在隔离上下文里扫描 auth 模块，返回：
- Bug #1: Race condition in token refresh — 两个并发请求同时检测到 token 过期
  同时发起刷新，旧的 refresh_token 被覆盖，导致第一个请求的会话失效
- Bug #2: Unlocked read in user lookup — 用户查询使用了只读事务但没有锁

案例 2：架构审查

输入："Use the design-reviewer agent to evaluate the current data layer design"
输出：agent 分析数据层架构，报告：
- 发现了三个上帝对象，建议拆分为 Repository + Unit of Work
- 某服务类同时依赖了 7 个外部服务，违反了单一职责原则
- 建议引入领域事件解耦

GitHub: https://github.com/gsscoder/claude-coding-agents