本地跑得挺顺的代码一推到线上就报错。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-patternsskill 给的就是 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-learningskill 在 Stop 钩子里顺手把这次调试的非平凡发现提炼成可复用 skill下回直接加载。命名风格飘→rules/typescript、rules/python等语言目录里就是各语言的强制编码规范——命名、错误处理、不可变性、文件组织全是明文写的。Claude Code 在你的项目里跑自动加载这套规范。改一处坏一处→verification-loop、eval-harness两个 skill 把checkpoint-based eval和continuous eval两种验证模式都内置了e2e-testingskill 配套 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.git cd everything-claude-code mkdir -p ~/.claude/rules cp -R rules/common ~/.claude/rules/ cp -R rules/typescript ~/.claude/rules/ # 选你用的语言Windows 下用 PowerShellpowershellNew-Item -ItemType Directory -Force -Path $HOME/.claude/rules | Out-Null Copy-Item -Recurse rules/common $HOME/.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-* 命令还要再装一层