听起来不大。干起来才发现处处别扭。本地跑得挺顺的代码一推到线上就报错。pip install 装出来的版本和 lock 文件对不上celery worker 启动报 ImportError邮件发送的 SMTP 凭据在 .env.example 里少了一行。前端那边更糟登录页的 UI 调了三版老陈总觉得差点味道——按钮圆角、字体、留白单独看都没问题搁一起就散。他试过 GitHub Copilot提示贴脸但不会动项目。试过 Cursor能改但分不清当前项目的命名规范。试过把项目丢给网页版 Claude让它看 README 后写代码——写是写了第二次开窗口又得把背景从头讲一遍。每次提 PR老陈都在跟同一组问题搏斗环境对不上、UI 没标准、跨会话丢上下文、命名风格飘。问题不在他不会写。在他和 AI 助手之间缺一套能稳定发挥的运行环境。二、问题不在模型在 Harness这个词是跟 affaan 的推文学的harness。原意是马具引申到 AI 语境就是套在 agent 外面的那一整套基础设施——skill、agent、hook、rule、memory、tool surface、verification loop。模型再强套在一团乱的 harness 上跑出来的效果也飘。老陈后来回想撞上的每一类问题几乎都能映射到 harness 的某个组件效果不好的场景 harness 哪块没做对本地和线上依赖对不上 rules 缺项目级规范hooks 缺 pre-commit 锁版本UI 调三版还是差口气 skill 缺 design system / frontend-patterns跨会话总是从头讲背景 缺 SessionStart/Stop 钩子、缺 memory 落盘命名风格飘忽不定 rules 缺语言级编码规范改完一个文件另一个文件莫名坏掉 缺 verification loop、缺 e2e-testing不同 AI 助手效果差异巨大 没统一的 MCP 配置、没统一的工具 surface每一行都是工程问题不是 prompt 问题。三、ECC 是什么Claude Code 的 Harness 框架ECC 全称 Everything Claude Code。GitHub 仓库 affaan-m/everything-claude-code目前 14 万 star、21k fork、170 多个贡献者。作者 affaanmustafaAnthropic x Forum Ventures 黑客松的获胜者——他用 Claude Code 配合这套配置做了 zenith.chat2025 年 9 月拿的奖。官方 README 开头那句话很关键来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合。不止是配置文件而是一整套完整系统技能体系、本能行为、记忆优化、持续学习、安全扫描以及研究优先的开发模式。它的定位很清晰ECC 不是 Claude Code 的替代品也不是某个 IDE 插件。它是 Claude Code以及 Codex、Cursor、OpenCode、Gemini的 harness 框架——把如何让 agent 在你的项目里稳定发挥这件事开箱即用地做成了一套可复用资产。仓库里大致这些东西63 个 sub-agentplanner、architect、code-reviewer、python-reviewer、go-build-resolver……251 个 skill按语言和领域分门别类79 个 slash command含 multi-* 系列一套 hooksPreToolUse、PostToolUse、Stop、SessionStart、PreCompact……12 个语言目录的 rulescommon、typescript、python、golang、swift、php……跨平台 Node.js 脚本Windows / macOS / Linux 都跑得动配套还有两个指南Shorthand Guide 讲基础搭建Longform Guide 讲 token 经济、内存持久化、验证循环、并行化策略。基础先读 Shorthand进了门再看 Longform。把 ECC 装上相当于给 Claude Code 套上 affaan 那匹跑赢黑客松的马具。四、ECC 怎么把那些差口气的场景一个个对号入座老陈装了 ECC 之后把自己的痛点挨个对了一遍官方文档发现每一项都有现成方案。环境对不上 → rules/common/coding-style.md 强制把依赖锁文件、pre-commit 配置写进项目规范scripts/hooks/pre-compact.js 之类的钩子会在写文件前检查 lock 状态deployment-patterns skill 给的就是 Docker 健康检查 回滚的标准做法。UI 差口气 → frontend-patterns 和 react-patterns 两个 skill 内置了 design system 接入流程frontend-slides、liquid-glass-design 等 skill 让 UI 风格有据可依frontend-a11y 把无障碍硬指标也带上了。跨会话丢上下文 → SessionStart、PreCompact、Stop 三个钩子形成闭环会话开始自动从 ~/.claude/sessions/YYYY-MM-DD-topic.tmp 加载上次的状态上下文快撑爆时 PreCompact 把关键信息落盘会话结束 Stop 钩子把今日决策、踩过的坑、未完成项写到当日 session 文件。continuous-learning skill 在 Stop 钩子里顺手把这次调试的非平凡发现提炼成可复用 skill下回直接加载。命名风格飘 → rules/typescript、rules/python 等语言目录里就是各语言的强制编码规范——命名、错误处理、不可变性、文件组织全是明文写的。Claude Code 在你的项目里跑自动加载这套规范。改一处坏一处 → verification-loop、eval-harness 两个 skill 把checkpoint-based eval和continuous eval两种验证模式都内置了e2e-testing skill 配套 Playwright 模式tdd-workflow 让 agent 写代码前先写测试。不同 AI 助手效果差异 → ECC 兼容 Claude Code、Codex、Cursor、OpenCode、Gemini 一堆 harness。这意味着同一套配置换模型不换规则效果相对稳定。安全问题 → 配套工具 AgentShieldnpx ecc-agentshield scan扫 CLAUDE.md、settings.json、MCP 配置、hooks、agent 定义5 大类密钥检测14 种模式、权限审计、钩子注入分析、MCP 服务风险评估、agent 配置审查。返回 A-F 等级CI 退出码 2 直接挂门禁。把官方文档翻完老陈那张问题—harness 组件对照表每一行都有了对应。五、安装分两条路5.1 推荐方式作为插件bash/plugin marketplace add https://github.com/affaan-m/ECC/plugin install eccecc装完即可使用 63 个 agent、251 个 skill、79 个 command。命名空间是 ecc:所以命令长这样bash/ecc:plan “添加用户认证”/ecc:code-review5.2 ⚠️ rules 不会自动装这是新手最容易栽的坑。Claude Code 插件系统不支持通过插件分发 rules是上游限制。所以装完插件后要再手动复制 rules 目录bashgit clone https://github.com/affaan-m/everything-claude-code.gitcd everything-claude-codemkdir -p ~/.claude/rulescp -R rules/common ~/.claude/rules/cp -R rules/typescript ~/.claude/rules/ # 选你用的语言Windows 下用 PowerShellpowershellNew-Item -ItemType Directory -Force -Path “HOME/.claude/rules∣Out−NullCopy−Item−Recurserules/commonHOME/.claude/rules | Out-Null Copy-Item -Recurse rules/common HOME/.claude/rules∣Out−NullCopy−Item−Recurserules/commonHOME/.claude/rules/”Copy-Item -Recurse rules/typescript “$HOME/.claude/rules/”不要同时跑 ./install.sh --profile full 或 npx ecc-install --profile full。插件已经会自动加载 ECC 的 skills、commands 和 hooks再执行完整安装会把同一批内容再次复制到用户目录导致技能重复、运行时行为重复。5.3 multi-* 命令还要再装一层/multi-plan、/multi-execute、/multi-backend、/multi-frontend、/multi-workflow 这几个 multi-* 命令需要额外运行时bashnpx ccg-workflow它会装两个关键组件~/.claude/bin/codeagent-wrapper 和 ~/.claude/.ccg/prompts/。没装的话这几个 multi-命令直接报缺组件。5.4 装好第一件事跑 AgentShieldbashnpx ecc-agentshield scan扫一遍当前项目配置密钥、权限、钩子注入、MCP 风险一次性出报告。CI 挂门禁就用这条命令。六、配置原则装上不算完得按需精简ECC 装完默认是开箱即用——所有 skill、所有 agent、所有 MCP 都注册着。这对个人玩具项目挺爽对生产项目就是性能灾难。README WARNING 里那句话说得很直白不要一次启用所有 MCP。如果启用了太多工具你的 200k 上下文窗口可能会缩小到 70k。6.1 三个硬指标全局配置 20-30 个 MCP单项目启用 10 个活动工具 80 个6.2 老陈的精简顺序先砍 MCP。Playwright 和 Chrome DevTools 都暴露了 click、screenshot、navigate、type功能高度重叠。Python 后端 React 前端浏览器测试主要靠 Playwright于是关掉 Chrome DevTools。接着是行业 skill。healthcare-、defi-、homelab-、wireguard-、marketing-、recsys-——这些是通用 Agent OS 的行业模板不是 coding runtime。一个都不留。最后是 agent。保留 6 个就够planner、architect、code-reviewer、python-reviewer、typescript-reviewer、performance-optimizer。删掉 swift-reviewer、rust-reviewer、cpp-reviewer、go-reviewer 这些用不上的语言审查 agent删掉 chief-of-staff、silent-failure-hunter、conversation-analyzer 这些实验型 agent。6.3 包管理器和钩子严格度bashexport CLAUDE_PACKAGE_MANAGERpnpm # 强制用 pnpmexport ECC_HOOK_PROFILEstandard # strict | standard | offexport ECC_DISABLED_HOOKS“pre:bash:tmux-reminder” # 临时闭嘴ECC 自动检测顺序环境变量 → .claude/package-manager.json → package.json 的 packageManager 字段 → 锁文件 → 全局配置。精简完之后老陈那个项目跑起来才顺了手。七、跨平台Windows 也能照着敲