awesome-claude-notes

awesome claude notes

语言

• 简体中文（当前）
• 简体中文镜像
• Português (Brasil)
• 繁體中文
• 日本語
• 한국어
• Türkçe

一套面向 Claude Code 与多种 AI coding harness 的生产级工作流资产库。

把 AI coding agent 从“偶尔好用”，推进到“稳定可复用”。

awesome claude notes 提供已经打磨过的 agents、skills、commands、rules、hooks、 MCP configs 和跨平台脚本，帮助你更快搭起一套可落地的 agent harness，而不是从零 拼装目录、提示词和自动化流程。

[!IMPORTANT] 本仓库是基于 affaan-m/ECC 的独立社区发行版， 重点维护中文文档、打包与跨工具使用体验，并非官方上游。原作者、贡献者和 MIT 许可证信息均予以保留；同步与差异策略见 UPSTREAM.md。

为什么会用它

你通常会在下面这些场景里需要这个仓库：

• 你想快速得到一套能直接落地的 Claude Code 工作流。
• 你需要的不只是提示词，而是一整套 agents、rules、hooks 和 commands。
• 你希望同一套方法可以覆盖 Claude Code、Cursor、Codex、OpenCode 等工具。

你会得到什么

• 更快开始：直接复用现成的目录结构、命令和默认约束。
• 更稳的工作流：把常见的开发、评审、测试和安全检查沉淀成可重复流程。
• 更少重复搭建：不用自己从头整理 agents、skills、rules、hooks 和 MCP 配置。
• 更好的跨工具迁移：同一套资产可复用到多个 agent / IDE / CLI 组合中。

说明：当前仓库默认以中文作为根 README 展示，README.zh-CN.md 为同步镜像；旧资料里出现的历史仓库名通常只是旧截图或旧安装残留。

2 分钟开始

推荐路径只保留一条：先安装插件，再安装你当前语言需要的规则和命令。

Quick start gives you access to 28 agents, 125 skills, and 60 commands.

1. 安装插件

/plugin marketplace add loulanyue/awesome-claude-notes
/plugin install awesome-claude-notes@awesome-claude-notes

2. 安装语言资产

Claude Code 插件不会自动分发 rules，所以这一步仍然必需。

git clone https://github.com/loulanyue/awesome-claude-notes.git
cd awesome-claude-notes
npm install
npx ecc typescript

可替换语言示例：python、golang、swift、php。 兼容旧入口：npx ecc-install typescript。

3. 直接开始用

/awesome-claude-notes:plan "Add user authentication"

如果你是手动安装命令，也可以直接使用： /plan "Add user authentication"。

接下来该看哪份文档

• 想先判断项目是否适合你：the-shortform-guide.md
• 想系统理解方法论：the-longform-guide.md
• 想看安全与防护重点：the-security-guide.md
• 想看完整安装、平台和扩展说明：docs/zh-CN/README.md
• 想按模块选择性安装： docs/SELECTIVE-INSTALL-ARCHITECTURE.md （当前主要为英文）
• 想查看最近版本变化： Releases
• 安装或运行遇到问题：TROUBLESHOOTING.md

仓库里包含什么

这个仓库的核心目录与能力如下：

Category	Snapshot	Notes
Agents	✅ 28 agents	Specialized subagents for planning, review, build fixing, and orchestration
Commands	✅ 60 commands	Slash-command workflows for planning, testing, review, and maintenance
Skills	✅ 125 skills	Reusable workflow and domain-knowledge modules across harnesses

• agents/：专用子代理，例如 planner、architect、code-reviewer、build resolver。
• skills/：工作流定义与领域知识模块。
• commands/：可直接调用的 slash commands，如 /plan、/tdd、/code-review。
• hooks/：基于工具和生命周期事件的自动化。
• rules/：始终生效的公共规则与语言专属规则。
• mcp-configs/：外部集成所需的 MCP 配置。
• scripts/：跨平台 Node.js 安装与运维脚本。
• tests/：脚本与安装器的验证用例。

从 package.json 当前发布内容看，仓库同时覆盖 Claude、Cursor、Codex、 OpenCode 相关资产，以及 ecc / ecc-install 两个 CLI 入口。

平台支持摘要

• Claude Code：推荐主路径，插件、commands、hooks、rules 支持最完整。
• Cursor：提供适配后的 rules、skills、commands 与相关配置。
• Codex：提供 .codex/ 与 AGENTS.md 体系，约束能力更依赖说明文件和沙箱配置。
• OpenCode：提供对应 commands、instructions、plugins 与工具层适配。
• 操作系统：脚本基于 Node.js，面向 macOS、Linux、Windows。

精简 FAQ

为什么安装插件后还要执行 npx ecc <language>？

因为 Claude Code 插件本身不能自动分发 rules。 推荐保留插件安装，再用 npx ecc <language> 安装当前语言所需资产。

可以只装一部分吗？

可以。选择性安装入口保留为： npx ecc install --profile ... 或 npx ecc install --modules ...。 详细说明见 docs/SELECTIVE-INSTALL-ARCHITECTURE.md。

可以完全手动安装吗？

可以。如果你希望自己管理 ~/.claude/agents/、~/.claude/rules/、 ~/.claude/commands/、~/.claude/skills/，请参考完整说明： docs/zh-CN/README.md。

遇到 Duplicate hooks file 怎么办？