ClaudeCode / Codex能力增强与团队多Agent协作实战指南

[一、全景认知：Skills / Plugins / Hooks / MCP / Subagents 五层架构](#一、全景认知：Skills / Plugins / Hooks / MCP / Subagents 五层架构)
[二、必装 Skills 清单：从编码行为到工程规范](#二、必装 Skills 清单：从编码行为到工程规范)
[三、必装 Plugins 清单：从工作流到外部集成](#三、必装 Plugins 清单：从工作流到外部集成)
[四、必装 MCP Server 清单：扩展 Agent 感知边界](#四、必装 MCP Server 清单：扩展 Agent 感知边界)
[五、团队多 Agent 协作：从单兵到编队](#五、团队多 Agent 协作：从单兵到编队)
六、完整装备方案与安装脚本
[七、CLAUDE.md / AGENTS.md 团队模板](#七、CLAUDE.md / AGENTS.md 团队模板)
八、每日工作流与最佳实践
九、关键资源索引

一、全景认知

Claude Code / Codex 的五层扩展架构

要理解该装什么、为什么装，先看清扩展机制的层次关系：

复制代码

┌──────────────────────────────────────────────────────────────────┐
│ 第5层  多 Agent 编排                                              │
│   Claude Squad / claude-flow / AgentsRoom                        │
│   并行会话 · 角色分工 · 任务分派 · 跨项目协调                       │
├──────────────────────────────────────────────────────────────────┤
│ 第4层  Subagents（子Agent）                                       │
│   .claude/agents/*.md  /  .codex/agents/                         │
│   独立上下文 · 专项职责 · 被主Agent调度                             │
├──────────────────────────────────────────────────────────────────┤
│ 第3层  Hooks（生命周期钩子）                                       │
│   PreToolUse / PostToolUse / Notification                        │
│   自动格式化 · 安全门禁 · 提交规范 · 上下文注入                     │
├──────────────────────────────────────────────────────────────────┤
│ 第2层  Plugins = MCP Server + Skills + Hooks + Subagents 的打包   │
│   /plugin install xxx  /  ccpi install xxx                       │
│   完整功能集成 · 外部服务连接 · 复合工作流                          │
├──────────────────────────────────────────────────────────────────┤
│ 第1层  Skills（轻量指令）                                         │
│   SKILL.md（~100 tokens 索引开销，任务匹配时才加载完整指令）         │
│   编码准则 · 设计规范 · 性能标准 · 领域知识                         │
├──────────────────────────────────────────────────────────────────┤
│ 第0层  CLAUDE.md / AGENTS.md（项目指令文件）                       │
│   每次会话自动加载 · 项目约定 · 技术栈 · 团队规范                    │
└──────────────────────────────────────────────────────────────────┘

关键认知：

Skills 是 ROI 最高的扩展：零运行时依赖、上下文开销极低（未激活仅~100 tokens）、跨 Claude Code / Codex / Cursor / Gemini CLI / Copilot 通用
Plugins 是深度集成的载体：打包了 MCP + Skills + Hooks + Subagents，适合连接外部服务或封装复杂工作流
MCP Server 是感知扩展的通道：让 Agent 能访问数据库、网页、文档、监控等外部世界
多 Agent 编排是团队级乘数：5 人团队各开 3 个 Agent = 15 个 Agent 并行运作

两类 Skills 的本质区别

类型	定义	价值	举例
能力提升型 (Capability Uplift)	赋予 AI 原本不具备的能力	解锁新场景	Firecrawl（网页抓取）、Document Skills（文档生成）、Webapp Testing（浏览器测试）
偏好编码型 (Encoded Preference)	编码团队特定的工作方式和标准	消除 AI slop，保证一致性	Karpathy Skills（行为准则）、React Best Practices（性能标准）、Frontend Design（设计方向）

二、必装 Skills 清单

按 安装优先级 排列。每个 Skill 均标注了它解决的核心问题、与同类的差异、以及在 Claude Code 和 Codex 上的安装方式。

第一优先级：编码行为规范（Day 1 必装）

这类 Skills 改变的是 AI 如何思考和行动，是全局性的行为改善，所有项目都应安装。

1. Karpathy Skills ⭐ 145K


解决的问题	LLM 三大通病：悄悄做错误假设、过度工程化、随意修改无关代码
核心内容	4 条行为准则的单文件 CLAUDE.md
官网	github.com/multica-ai/andrej-karpathy-skills
安装	`curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md`

四条准则详解：

准则	它解决什么	安装前 vs 安装后
Think Before Coding	AI 悄悄选了一个假设就全速推进	→ 遇到歧义时列出多种解读，等你确认
Simplicity First	50 行能解决的写了 500 行	→ 不添加未请求的功能、抽象、类型注解
Surgical Changes	修一个 Bug 顺手重构了半个文件	→ 只碰必须碰的代码，发现死代码只提不删
Goal-Driven Execution	"加个验证"没有完成标准	→ 先定义成功标准（写测试），循环到通过

为什么排第一 ：零配置、单文件、所有项目通用、立即见效。它和 Superpowers 是互补关系------Karpathy 管"不要做什么"，Superpowers 管"按什么流程做"。

2. Superpowers ⭐ 201K


解决的问题	AI 编码缺乏系统方法论，容易在长任务中上下文漂移
核心内容	完整的结构化开发方法论：头脑风暴 → 计划 → 子Agent执行 → TDD → 代码审查 → 合并
官网	github.com/obra/superpowers
安装	`npx skills add obra/superpowers`

包含的核心 Skills：

Skill	触发方式	功能
`/brainstorm`	显式调用	通过结构化提问精炼需求，生成设计文档
`/write-plan`	显式调用	将设计拆解为 2-5 分钟粒度的任务，含文件路径和验证步骤
`/execute-plan`	显式调用	为每个任务启动独立子Agent，双重审查（规格合规+代码质量）
`using-git-worktrees`	自动激活	创建隔离分支，确保测试基线干净再开始
`test-driven-development`	自动激活	强制先写失败测试，再写代码，删除测试前写的代码
`finishing-a-development-branch`	显式/自动	验证测试通过后提供 4 种合并选项（本地合并/创建PR/保留/丢弃）

和 Karpathy 的区别 ：Karpathy 是行为守卫（防止犯错），Superpowers 是流程引擎（指导正确的做事方式）。两者叠加使用效果最佳。

和 ECC 的区别 ：ECC（188K⭐, github.com/affaan-m/ECC）更偏向 Agent 性能优化和安全加固（npm 包形式），适合企业安全合规场景。Superpowers 更偏向开发方法论。

3. Grill Me（设计审查）⭐ Matt Pocock 87.3K（合集）


解决的问题	动手写代码之前没有充分审视方案的隐含假设和依赖链
核心内容	通过苏格拉底式的连环追问，压力测试你的设计方案
官网	github.com/mattpocock/skills
安装	`npx skills add https://github.com/mattpocock/skills --skill grill-me` Codex: `$skill-installer grill-me`

和 Superpowers /brainstorm 的区别：/brainstorm 帮你从无到有构建方案，grill-me 是拿着你已有的方案做压力测试。先 brainstorm 再 grill-me 是最佳流程。

第二优先级：前端工程规范（Web 项目必装）

这四个 Vercel + Anthropic 的 Skills 互补而非互斥，覆盖设计→组件→性能→合规的完整前端质量链条。

#	Skill	维护方	周安装量	核心功能	解决的问题
4	Frontend Design	Anthropic 官方	110K+	突破模板化设计，强制确定视觉方向	AI 生成的 UI 全长一个样（Inter 字体+紫色渐变+卡片布局）
5	Web Design Guidelines	Vercel Engineering	133K+	100+ 条 UI/UX 审计规则，输出 file:line 精准定位	赶工时遗漏的无障碍/焦点/ARIA/触摸目标/键盘导航
6	React Best Practices	Vercel Engineering	---	57 条性能规则，按实际影响排序	先消除请求瀑布，再优化 Bundle，最后才管 useMemo
7	Composition Patterns	Vercel Labs	---	复合组件模式替代 boolean prop 地狱	`<Alert isDestructive>` → `<Alert.Destructive>`

官网：github.com/vercel-labs/agent-skills · 搜索目录 skills.sh

安装（一条命令全装）：

bash 复制代码

npx skills add https://github.com/anthropics/skills --skill frontend-design
npx skills add https://github.com/vercel-labs/agent-skills --skill web-design-guidelines vercel-react-best-practices composition-patterns

推荐工作流顺序：

复制代码

设计阶段 → Frontend Design（确定视觉方向：极简/赛博/编辑式...）
编码阶段 → Composition Patterns（确定组件 API 模式）
         → React Best Practices（性能优化，按影响排序）
审查阶段 → Web Design Guidelines（WCAG/无障碍合规检查）

第三优先级：能力扩展（按需安装）

这类 Skills 赋予 Agent 原本不具备的能力。

#	Skill	官网	解决的问题	安装方式	外部依赖
8	Firecrawl	firecrawl.dev	Agent 需要实时网页数据（文档/竞品/API变更）	`npx -y firecrawl-cli@latest init --all --browser`	API Key（免费1000 credits/月）
9	Document Skills (PDF/DOCX/XLSX/PPTX)	github.com/anthropics/skills	需要生成/解析真实文档文件	`npx skills add anthropics/skills --skill pdf docx xlsx pptx`	Python 运行时
10	Webapp Testing	同上	需要在真实浏览器中测试 UI 交互	`npx skills add anthropics/skills --skill webapp-testing`	Playwright
11	Trail of Bits Security	github.com/trailofbits/skills	需要专业级安全审计（非检查清单级）	`npx skills add trailofbits/skills`	CodeQL / Semgrep
12	MCP Builder	github.com/anthropics/skills	需要构建高质量 MCP Server	`npx skills add anthropics/skills --skill mcp-builder`	无
13	Skill Creator	同上 · 也可 claude.com/plugins/skill-creator	需要将团队工作流编码为可复用 Skill	`npx skills add anthropics/skills --skill skill-creator`	无
14	Remotion Best Practices	remotion.dev · github.com/remotion-dev/skills	React 编程式视频项目	`npx skills add remotion-dev/skills --skill remotion-best-practices`	Remotion 框架

Firecrawl 深入对比（它和 Codex 内置搜索的区别）：

维度	Codex 内置 Web Search	Firecrawl Skill
数据源	预抓取的过期缓存	实时网页抓取
JS 渲染	❌ 不支持	✅ 自动处理
输出	片段塞入上下文	文件输出，不占上下文
能力	仅搜索	搜索/抓取/爬取/交互/浏览器/Agent 6 个命令
内容召回率	未公开	80%+（基准测试最高）

第四优先级：GIT/PR 工作流 Skills（Codex 生态特色）

这些是 Codex 官方 Skills 仓库（github.com/openai/skills）中的精选，也可在 Claude Code 上使用。

#	Skill	核心功能	安装方式
15	yeet	一键 stage → commit → push → 创建 PR（自动发现 PR 模板）	`$skill-installer yeet`
16	gh-address-comments	读取 PR 审查评论，选择性修复（不盲目全改）	`$skill-installer gh-address-comments`
17	gh-fix-ci	诊断 GitHub Actions 失败原因，审批后修复	`$skill-installer gh-fix-ci`
18	cli-creator	构建可复用 CLI 工具 + 配套 Skill，供未来 Agent 调用	`$skill-installer cli-creator`
19	migrate-to-codex	将 Claude Code 的 Skills/Hooks/MCP 配置迁移到 Codex 格式	`$skill-installer migrate-to-codex`

第五优先级：垂直领域 Skills

#	Skill	Stars	官网	适用场景
20	GStack (Garry Tan)	40.9K	github.com/garrytan/gstack	需要模拟工程团队角色（Office Hours/设计/代码审查/QA）
21	Marketing Skills (Corey Haines)	30K	github.com/coreyhaines31/marketingskills	营销（41 个 Skill 覆盖 CRO/文案/SEO/增长）
22	ECC (Everything Claude Code)	188K	github.com/affaan-m/ECC	企业安全合规（ecc-universal + ecc-agentshield npm 包）

三、必装 Plugins 清单

Plugins 是比 Skills 更重的集成方式，适合需要连接外部服务或封装复杂工作流的场景。

Plugin 市场与安装方式

渠道	覆盖量	安装方式
tonsofskills.com (社区最大)	425 Plugins	`pnpm add -g @intentsolutionsio/ccpi` → `ccpi install xxx`
Anthropic 官方目录	45+ 验证	`/plugin marketplace add anthropics/claude-plugins-official`
Codex 内置	系统 Skills	`$skill-installer xxx`

开发工作流 Plugins（提升日常效率）

#	Plugin	官网/来源	核心功能	为什么值得装
1	Taskmaster ⭐ 27K	github.com/eyaltoledano/claude-task-master	PRD → 任务分解 → 依赖跟踪 → Agent 执行（36 个 MCP 工具）	项目管理层的 AI 化，对接 Cursor/Windsurf/Roo
2	overnight-dev	marketplace	Git Hooks 强制 TDD，Claude 夜间自治 6-8 小时	睡觉时间也在生产，醒来收获通过测试的完整 Feature
3	sprint	marketplace	写规格 → 运行 `/sprint` → 多 Agent 自主分工（前端/后端/测试）并行开发	Sprint 级别自动化交付
4	gh-dash	marketplace	GitHub PR 看板：状态/CI/Bot评论/合并，终端内完成	不离开终端管理 PR
5	code-cleanup	marketplace	11 维度代码质量扫描（死代码/重复/弱类型/循环依赖...）	技术债自动识别和清理
6	claude-never-forgets	marketplace	跨会话持久记忆（偏好/决策/修正）	不再每次重新解释你的习惯

Taskmaster 与 Superpowers 的区别与互补：

维度	Taskmaster	Superpowers
定位	项目管理工具（PRD → 任务列表）	开发方法论（设计 → TDD → 审查 → 合并）
输入	PRD / Feature Spec 文档	头脑风暴结果 / 设计文档
管理粒度	任务级（含依赖关系、优先级）	代码级（含测试、分支、合并）
最佳搭配	Taskmaster 做任务拆解 → Superpowers 执行每个任务

SaaS 集成 Packs（按项目技术栈选装）

市场上有 106 个 SaaS Skill Packs。以下是最高频使用的，每个包含 18-38 个针对该服务优化的 Skills：

Pack	Skills 数	安装命令	适用于
supabase-pack	30	`ccpi install supabase-pack`	Supabase 全栈（Auth/DB/Storage/Realtime/Edge）
vercel-pack	30	`ccpi install vercel-pack`	Vercel 部署/Edge/预览/性能
sentry-pack	30	`ccpi install sentry-pack`	错误监控/性能追踪/Session Replay
shopify-pack	38	`ccpi install shopify-pack`	Shopify 电商开发
linear-pack	24	`ccpi install linear-pack`	Linear Issue/项目管理集成
posthog-pack	24	`ccpi install posthog-pack`	产品分析/Feature Flags/实验
langchain-py-pack	68 条规则	`ccpi install langchain-py-pack`	LangChain 1.0 + LangGraph 1.0 AI 应用开发

安全类 Plugins（安全敏感项目选装）

Plugin	安装命令	覆盖范围
vulnerability-scanner	`ccpi install vulnerability-scanner`	代码+依赖+配置全面扫描，CVE 检测
secret-scanner	`ccpi install secret-scanner`	扫描暴露的密钥/API Key/密码
dependency-checker	`ccpi install dependency-checker`	依赖漏洞+过期+许可证合规
owasp-compliance-checker	`ccpi install owasp-compliance-checker`	OWASP Top 10 合规

四、必装 MCP Server 清单

MCP (Model Context Protocol) 让 Agent 能感知代码库之外的世界。截至 2026 年 5 月已有 28,577+ MCP Server 被索引。以下按优先级精选：

必装（Day 1）

MCP Server	官网	核心能力	为什么必装
Context7	context7.com · github.com/upstash/context7	实时查询 100+ 库的版本特定文档	解决幻觉的根源------Agent 用的是最新文档而非训练数据
GitHub MCP	github.com/github/github-mcp-server	仓库/PR/Issue/Commit 管理	Claude 自主管理分支、读提交历史、提交 PR

强烈推荐（Week 1）

MCP Server	官网	核心能力	价值
Firecrawl MCP	firecrawl.dev	网页抓取/搜索/浏览器自动化	80%+ 内容召回率，JS 渲染自动处理
Playwright MCP	github.com/microsoft/playwright-mcp	浏览器自动化/测试	微软官方，跨浏览器测试
agent-lsp	github.com/agent-lsp/agent-lsp	50+ LSP 工具，30 语言	5-34x token 节省 vs grep/read，类型感知

按需（项目相关）

MCP Server	适用场景
Supabase MCP	Supabase 全栈项目的数据层直接访问
Sentry MCP	运行时错误/性能数据直接反馈给 Agent
Lightrun MCP	Agent 基于运行时上下文做代码设计决策
Stripe MCP	支付集成项目
Sequential Thinking	复杂问题分步推理

五、团队多 Agent 协作

这是整个报告的核心部分。一个人用好 Claude Code 是 5x 提效，一个团队用好多 Agent 协作是 指数级提效。

5.1 团队协作的三个层次

复制代码

Level 1: 共享配置（团队一致性）
   CLAUDE.md + .claude/settings.json + Hooks → git 提交 → 团队成员 clone 即继承
   ↓
Level 2: 角色分工（专项子Agent）
   .claude/agents/ 下定义多个角色（前端/后端/QA/安全/架构师...）
   ↓
Level 3: 并行编排（多Agent同时工作）
   编排工具管理多个Agent会话 → 并行开发 → 统一审查合并

5.2 Level 1：团队共享配置（所有团队必做）

核心原则：所有 Agent 配置都通过 git 管理，新成员 clone 即继承全部 AI 工作环境。

需要提交到 git 的文件：

文件	Claude Code 路径	Codex 路径	作用
项目指令	`CLAUDE.md`	`AGENTS.md`	每次会话自动加载的项目上下文、编码规范
Hooks 配置	`.claude/settings.json`	`.codex/hooks.json`	自动格式化/安全门禁/提交规范/上下文注入
子Agent定义	`.claude/agents/*.md`	`.codex/agents/*.md`	角色化Agent模板
项目级Skills	`.claude/skills/`	`.agents/skills/`	团队共享的自定义 Skills
团队Prompt库	`.agentsroom/prompts.json`（可选）	---	复用的高质量 Prompt

必须配置的 Hooks：

json 复制代码

// .claude/settings.json 示例
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "write_file",
        "command": "echo 'Reminder: follow CLAUDE.md coding standards'"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "write_file",
        "command": "npx prettier --write $FILE_PATH"
      }
    ],
    "Notification": [
      {
        "matcher": "task_complete",
        "command": "notify-send 'Claude Code' 'Task completed'"
      }
    ]
  }
}

5.3 Level 2：角色化子 Agent（中型团队推荐）

在 .claude/agents/ 下为不同职责定义专项子 Agent，主 Agent 按需调度。

推荐的角色配置：

角色文件	职责	工具权限	何时被调度
`frontend.md`	前端组件/样式/交互开发	文件读写+浏览器	涉及 UI/组件的任务
`backend.md`	API/数据库/业务逻辑	文件读写+Shell	涉及服务端的任务
`qa.md`	测试编写+质量验证	文件读写+Shell（只读代码）	每次提交前
`security.md`	安全审计+漏洞扫描	只读+安全工具	PR 审查阶段
`architect.md`	架构决策+技术方案审查	只读	重大技术决策前
`devops.md`	CI/CD/部署/基础设施	文件读写+Shell	部署相关任务

子 Agent 模板示例 （.claude/agents/qa.md）：

markdown 复制代码

---
name: QA Engineer
description: 专项测试编写和质量验证子Agent
tools:
  - read_file
  - write_file
  - shell (read-only for test execution)
---

# QA Engineer Agent

## 职责
你是一个专注于测试质量的 QA 工程师。

## 工作流程
1. 阅读被测代码，理解业务逻辑和边界条件
2. 编写单元测试（覆盖正常路径+边界+错误场景）
3. 编写集成测试（覆盖模块间交互）
4. 运行测试并确保全部通过
5. 检查测试覆盖率，补充薄弱区域

## 规范
- 测试命名：describe('模块名', () => { it('should 行为描述', ...) })
- 每个测试只验证一个行为
- Mock 外部依赖，不 Mock 被测模块内部
- 测试数据使用 Factory 模式

5.4 Level 3：多 Agent 并行编排（追求最大产出）

这是将 "一个人 + 一个 Agent" 升级为 "团队 + Agent 编队" 的关键。

编排工具选型对比

工具	Stars	官网	核心模式	支持的 Agent	最适合谁
Claude Squad	7.5K	github.com/smtg-ai/claude-squad	tmux 管理并行会话，vim 键绑定	Claude Code/Codex/Aider/Gemini/OpenCode/Amp	终端党独立开发者，最快上手（<5s 启动 6 个会话）
claude-flow	52.6K	github.com/clamflow/claude-flow	多 Agent 群体(swarm)协调	多种 Agent	大规模并行任务，Agent 间自动协调
Emdash (YC W26)	4.5K	github.com/generalaction/emdash	Electron 桌面应用，$EMDASH_PORT 端口隔离	22+ CLI 提供商（最广）	混合 Agent 团队 + 桌面 UI 偏好
vibe-kanban	26.3K	github.com/BloopAI/vibe-kanban	Web 看板 + MCP 任务分解 + 浏览器预览	10+ Agent	可视化任务管理 + UI 预览
Bernstein	399	github.com/chernistry/bernstein	确定性调度 + Janitor 预合并验证	Claude Code/Codex/Gemini	需要质量门控 + 零 LLM 调度开销
AgentsRoom	---	agentsroom.dev	14 角色模板 + 桌面/移动端 + 团队 Prompt 库	Claude Code/Codex/Gemini/Aider	正式工程团队（跨项目/移动端/on-call）
Composio AO	社区	github.com/ComposioHQ/agent-orchestrator	CI 自动重试 + PR 级自治	Claude Code/Codex/Aider/OpenCode	GitHub Issue 驱动的自治工作流

选择决策

复制代码

你的团队规模和需求？
│
├─ 独立开发者，终端优先，想快速并行
│  → Claude Squad（5秒启动，vim键绑定，零学习成本）
│
├─ 小团队(2-5人)，需要可视化
│  → vibe-kanban（看板管理+浏览器预览）
│
├─ 中型团队(5-15人)，正式工程流程
│  → AgentsRoom（14角色+桌面/移动+团队Prompt库+token监控）
│
├─ 需要 Agent 间自动协调，任务规模大
│  → claude-flow（群体智能协调）
│
├─ 严格质量要求，需要预合并验证
│  → Bernstein（确定性调度+Janitor质检+零LLM调度开销）
│
└─ 团队使用多种不同的 Agent 工具
   → Emdash（22+提供商支持，端口隔离）

团队多 Agent 协作实战模式

模式一：角色分工并行（推荐起步）

复制代码

                    ┌──────────────┐
                    │   Tech Lead   │
                    │  (审查+决策)   │
                    └──────┬───────┘
                           │ 分派任务
              ┌────────────┼────────────┐
              ▼            ▼            ▼
       ┌──────────┐ ┌──────────┐ ┌──────────┐
       │ Agent #1  │ │ Agent #2  │ │ Agent #3  │
       │ 前端开发   │ │ 后端API   │ │ 测试编写   │
       │ worktree-1│ │ worktree-2│ │ worktree-3│
       └─────┬────┘ └─────┬────┘ └─────┬────┘
             │             │             │
             └─────────────┼─────────────┘
                           ▼
                    ┌──────────────┐
                    │  Agent #4    │
                    │  代码审查     │
                    │  (Janitor)   │
                    └──────┬───────┘
                           ▼
                      合并到 main

模式二：Swarm 群体协调（大规模任务）

复制代码

               ┌─────────────────────┐
               │  claude-flow 协调器   │
               │  任务分解 + 状态追踪  │
               └──────────┬──────────┘
                          │
     ┌────────────────────┼────────────────────┐
     ▼                    ▼                    ▼
┌─────────┐         ┌─────────┐         ┌─────────┐
│ Worker 1 │    ···  │ Worker N │    ···  │ Worker M │
│ 模块 A   │         │ 模块 B   │         │ 模块 C   │
└────┬────┘         └────┬────┘         └────┬────┘
     │                    │                    │
     └────────────────────┼────────────────────┘
                          ▼
                   协调器汇总+合并

模式三：异步接力（跨时区团队）

复制代码

时区 A (亚洲)                    时区 B (欧洲)                    时区 C (美洲)
┌─────────────────┐             ┌─────────────────┐             ┌─────────────────┐
│ 开发者 + Agent    │             │ 开发者 + Agent    │             │ 开发者 + Agent    │
│ 09:00-18:00     │             │ 09:00-18:00     │             │ 09:00-18:00     │
│                 │             │                 │             │                 │
│ 18:00 设置       │──── git ───→│ 09:00 接力       │──── git ───→│ 09:00 接力       │
│ overnight-dev   │             │ 审查夜间成果      │             │ 审查夜间成果      │
│ Agent 夜间自治   │             │ 继续开发         │             │ 继续开发         │
└─────────────────┘             └─────────────────┘             └─────────────────┘

共享层: CLAUDE.md + .claude/agents/ + .claude/skills/ + Hooks (全部 git 管理)
协调层: AgentsRoom / vibe-kanban (跨时区可见性)

六、完整装备方案与安装脚本

方案 A：个人开发者快速启动（~10 分钟）

bash 复制代码

#!/bin/bash
# === AI Coding 快速增强脚本 ===

# 1. 行为准则（最高优先级）
curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md

# 2. 开发方法论
npx skills add obra/superpowers

# 3. 设计审查
npx skills add https://github.com/mattpocock/skills --skill grill-me

# 4. 网页数据能力
npx -y firecrawl-cli@latest init --all --browser

# 5. 文档+测试能力
npx skills add https://github.com/anthropics/skills --skill pdf webapp-testing skill-creator mcp-builder

# 6. 前端质量（Web 项目）
npx skills add https://github.com/anthropics/skills --skill frontend-design
npx skills add https://github.com/vercel-labs/agent-skills --skill web-design-guidelines vercel-react-best-practices composition-patterns

# 7. 代码库打包
npx repomix

# 8. 并行会话管理
# macOS/Linux: brew install smtg-ai/tap/claude-squad
# 或: go install github.com/smtg-ai/claude-squad@latest

echo "✅ AI Coding 增强完成！重启 Claude Code 或 Codex 生效。"

方案 B：团队级完整配置（~20 分钟）

在方案 A 基础上追加：

bash 复制代码

# 9. Plugin CLI
pnpm add -g @intentsolutionsio/ccpi

# 10. 工作流 Plugins
ccpi install overnight-dev
ccpi install code-cleanup

# 11. 安全 Plugins
ccpi install vulnerability-scanner
ccpi install secret-scanner

# 12. SaaS 集成（按技术栈选装）
ccpi install supabase-pack    # 如果用 Supabase
ccpi install vercel-pack      # 如果用 Vercel
ccpi install sentry-pack      # 如果用 Sentry

# 13. 任务管理
npx task-master-ai init

# 14. 安全审计 Skills
npx skills add trailofbits/skills

# 15. 工程团队模拟
npx skills add https://github.com/garrytan/gstack

七、CLAUDE.md / AGENTS.md 团队模板

Claude Code 项目模板（CLAUDE.md）

markdown 复制代码

# 项目：[项目名称]

## 核心行为准则
- **编码前思考**：遇到歧义列出可能解读，等待确认后再动手
- **简单优先**：最少代码解决问题，不添加未请求的功能和抽象
- **精准修改**：只触碰必要的部分，发现无关问题只提不改
- **目标驱动**：先定义成功标准（测试），循环验证直到通过

## 技术栈
- 框架：Next.js 15 (App Router)
- 语言：TypeScript (strict mode)
- 数据库：Supabase (PostgreSQL + Auth + Storage)
- 样式：Tailwind CSS v4
- 测试：Vitest (单元) + Playwright (E2E)
- 部署：Vercel
- 包管理：pnpm

## 编码规范
- 函数式组件 + React Server Components 优先
- Zod 做所有外部输入的校验
- 错误处理使用 Result 模式而非 try-catch
- 文件命名：kebab-case，组件 PascalCase
- 提交信息：Conventional Commits (feat/fix/chore/docs)
- 分支命名：feature/xxx, fix/xxx, chore/xxx

## 项目结构
src/
  app/          # Next.js App Router 路由
  components/   # UI 组件
  lib/          # 工具函数和共享逻辑
  server/       # 服务端逻辑
  types/        # TypeScript 类型定义

## 测试规范
- 每个功能模块必须有对应测试
- 测试命名：describe('模块') → it('should 行为')
- Mock 外部依赖（API/DB），不 Mock 被测模块内部
- E2E 测试覆盖核心用户流程

## 活跃 Skills
- Superpowers：/brainstorm → /write-plan → /execute-plan
- Grill Me：重大技术方案实施前使用
- Firecrawl：需要查阅最新框架文档或竞品调研时使用
- Vercel Skills：前端组件开发和审查时自动激活

## MCP 服务器
- Context7：框架文档实时查询（避免使用训练数据中的过期 API）
- GitHub MCP：仓库管理/PR/Issue 自动化

Codex 项目模板（AGENTS.md）

markdown 复制代码

# AGENTS.md

## Project Context
[项目名称] - [一句话描述]

## Tech Stack
- [同上，适配 Codex 格式]

## Coding Standards
- [同上]

## Available Skills
- obra/superpowers: Structured development methodology
- firecrawl: Live web data access
- yeet: Stage → commit → push → PR in one flow
- gh-fix-ci: Diagnose and fix GitHub Actions failures
- gh-address-comments: Address PR review comments selectively

## Test Requirements
- Write failing tests before implementation
- All PRs must pass CI before merge

## Task Workflow
1. Understand the requirement fully (ask if ambiguous)
2. Write a plan with file paths and verification steps
3. Write failing tests first
4. Implement minimum code to pass tests
5. Run full test suite
6. Create PR with conventional commit message

八、每日工作流与最佳实践

AI Coding 每日时间线

复制代码

07:00  ┌─ 检查 overnight-dev 夜间成果
       │  git diff → 审查通过测试的代码 → merge 或修正
       └─ 约 15 分钟

08:00  ┌─ Taskmaster 查看今日任务优先级
       │  或 Linear/GitHub Issues 选取任务
       └─ 约 10 分钟

08:15  ┌─ grill-me 审查技术方案（如果是新 Feature）
       │  或 /brainstorm 从零构建方案
       └─ 约 20 分钟

08:45  ┌─ /write-plan 生成实施计划 → 审批
       │  计划拆解为 2-5 分钟粒度的任务
       └─ 约 10 分钟

09:00  ┌─ /execute-plan 启动子Agent执行
       │  同时：Claude Squad 并行处理其他任务
       │  子Agent独立上下文，RED-GREEN-REFACTOR
       └─ 持续工作，需要时介入

12:00  ┌─ GStack /code-review 审查上午产出
       │  或 gh-address-comments 处理 PR 反馈
       └─ 约 30 分钟

13:30  ┌─ 处理反馈 → Firecrawl 查最新文档/竞品方案
       │  Trail of Bits 安全扫描（安全敏感变更）
       └─ 持续工作

17:00  ┌─ yeet 一键提交+创建 PR
       │  Webapp Testing 浏览器验证关键流程
       │  gh-fix-ci 修复 CI 失败（如有）
       └─ 约 20 分钟

17:30  ┌─ 配置 overnight-dev 下一个任务
       │  设置 TDD 守卫 → Claude 夜间自治
       └─ 下班

→ 22:00-07:00  Claude 自治开发，Git Hooks 确保 TDD 质量

关键最佳实践

实践	具体做法	为什么重要
CLAUDE.md 作为活文档	每次引入新概念后要求 Agent 更新 CLAUDE.md	下次会话不丢失上下文
先 grill 再 code	技术方案实施前用 grill-me 压力测试	发现隐含假设，省去后期返工
Skill 叠加不冲突	Karpathy（行为守卫）+ Superpowers（流程引擎）+ Vercel（质量标准）同时启用	三层保障，各管各的维度
子Agent分而治之	复杂任务拆给专项子Agent，每个独立上下文	防止长任务中的上下文漂移
git 管理所有配置	CLAUDE.md / Hooks / Skills / Agents 全部 commit	新成员 clone 即继承完整 AI 环境
夜间自治+TDD 守卫	overnight-dev 必须搭配严格测试用例	无人值守时测试是唯一的质量保证
定期 code-cleanup	每周运行一次 11 维度代码扫描	技术债积累是 AI 高速产出的副作用

九、关键资源索引

资源	链接	用途
Skills 搜索引擎	skills.sh	按分类/作者/安装量搜索所有平台的 Skills
Plugin 社区市场	tonsofskills.com	425+ Plugins，19 分类，ccpi CLI 安装
Anthropic 官方 Skills	github.com/anthropics/skills	官方维护的 Skills（文档/测试/安全/创作）
Anthropic 官方 Plugin 目录	github.com/anthropics/claude-plugins-official	45+ 官方验证 Plugin
OpenAI 官方 Skills	github.com/openai/skills	Codex 官方 Skills 仓库（19.3K⭐）
Superpowers	github.com/obra/superpowers	201K⭐ 开发方法论框架
Karpathy Skills	github.com/multica-ai/andrej-karpathy-skills	145K⭐ 行为准则
Vercel Agent Skills	github.com/vercel-labs/agent-skills	前端质量三件套（133K 周安装）
MCP Server 目录	safemcp.info · mcpmarket.com	28,577+ MCP Server 索引
Claude Skills 策展	github.com/ComposioHQ/awesome-claude-skills	1000+ Skills 分类策展
Claude 全生态策展	github.com/hesreallyhim/awesome-claude-code	Skills/Hooks/Commands/Plugins/编排器
CLI Agent 策展	github.com/bradAGI/awesome-cli-coding-agents	80+ Agent 列表（备查）
Agent 编排评测	augmentcode.com/tools/open-source-agent-orchestrators	9 个编排工具深度评测
AgentsRoom 团队方案	agentsroom.dev	14 角色+桌面/移动+团队 Prompt 库

一句话总结 ：在 Claude Code / Codex 上安装 Karpathy（行为守卫）+ Superpowers（流程引擎）+ Firecrawl（能力扩展）+ Vercel 三件套（质量标准） ，配合 CLAUDE.md 团队配置 + 角色化子 Agent + Claude Squad 并行编排，就是当前 ROI 最高的 AI Coding 增强方案。先从复制一个 Karpathy 的 CLAUDE.md 文件开始------这一个动作，就能立即改善所有 AI 编码助手的行为质量。