Files

Yaojia Wang 26448c796e Merge remote-tracking branch 'origin/main'

# Conflicts:
#	4 - Resources/Claude-Code/Everything Claude Code 完整指南.md

2026-05-23 11:03:10 +02:00

16 KiB

Raw Blame History

created, updated, type, tags, source

created

updated

type

Everything Claude Code 完整指南

生产级 Claude Code 插件系统。v1.10.0（本地仓库实测 183 skills / 48 agents / 79 commands；marketplace 版可能更多——以本地 ls 结果为准）。方法论与最佳实践见 Everything Claude Code 方法论与最佳实践，按场景速查见 Everything Claude Code 用法速查。

仓库关键参考文档（实测路径 C:\Users\yaoji\git\OpenSource\everything-claude-code\）：

docs/COMMAND-AGENT-MAP.md — 命令↔agent↔skill 的官方对照表

COMMANDS-QUICK-REF.md — 59 命令速查（按作者口径）

the-longform-guide.md / the-shortform-guide.md — 官方长/短指南

skills/dmux-workflows/SKILL.md、skills/autonomous-agent-harness/SKILL.md、skills/claude-devfleet/SKILL.md — 三类编排机制

scripts/orchestrate-worktrees.js — 外部 tmux+worktree 编排脚本

自主循环和并行编排详见：Autonomous Loops 自主循环模式、dmux 多Agent并行编排、Ralphinho RFC-DAG 编排模式、Autonomous Agent Harness 自主代理框架、ECC 编排替代方案 (orchestrate 迁移)

项目架构

everything-claude-code/ (v1.10.0)
├── agents/     (~48) - 专用子代理（code-reviewer、planner、tdd-guide、...）
├── skills/     (~183) - 工作流定义和领域知识
├── commands/   (~79) - slash 命令
├── hooks/      - 基于事件的自动化（hooks.json + scripts/hooks/*）
├── rules/      - 始终遵循的规则（python/typescript/golang/... + common + zh）
├── scripts/    - 跨平台 Node.js 工具脚本（orchestrate-worktrees、harness-audit、...）
├── mcp-configs/- MCP 服务器配置模板
├── contexts/   - 动态注入的上下文文件
├── docs/       - COMMAND-AGENT-MAP、SKILL-PLACEMENT-POLICY 等
└── plugins/    - 独立子插件（gsd、obsidian、planning-with-files、...）

数字随版本浮动，以 ls commands/*.md | wc -l 等实测为准。

安装

# 插件安装
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

# Rules 安装 (v1.10.0 新方式：插件内置 install.sh)
# 插件缓存位于 ~/.claude/plugins/cache/everything-claude-code/ecc/{version}/
cd ~/.claude/plugins/cache/everything-claude-code/ecc/1.10.0
bash install.sh --profile full              # 安装全部 (608 files)
bash install.sh python typescript golang    # 按需选语言

v1.10.0 主要变更

Legacy Commands -> Skills 迁移

12 个 command 变为 legacy shim，推荐直接使用对应 skill：

Legacy Command	替代 Skill
`/ecc:orchestrate`	`dmux-workflows` / `autonomous-agent-harness`（注意：dmux 需 tmux，Windows 不可用。实际替代见下方）

orchestrate 迁移指南（详见 ECC 编排替代方案 (orchestrate 迁移)）：

单功能：/ecc:feature-dev "描述" — 7 阶段全流程，Windows 可用

手动拆步：/ecc:plan → /ecc:tdd → /ecc:code-review → /ecc:verify

多阶段自动：/gsd:autonomous — GSD 系统，Windows 可用

Bug 修复：/ecc:tdd → /ecc:code-review

重构：/ecc:plan → /ecc:tdd → /ecc:code-review | /ecc:verify | verification-loop | | /ecc:tdd | tdd-workflow | | /ecc:eval | eval-harness | | /ecc:e2e | e2e-testing | | /ecc:docs | documentation-lookup | | /ecc:claw | nanoclaw-repl | | /ecc:agent-sort | agent-sort | | /ecc:context-budget | context-budget | | /ecc:devfleet | claude-devfleet | | /ecc:prompt-optimize | prompt-optimizer | | /ecc:rules-distill | rules-distill |

Legacy shim 仍然可用（向后兼容），只是内部转发到对应 skill。

模块化安装

新增 manifest-based 安装系统，20 个模块：

rules-core, agents-core, commands-core, hooks-runtime
platform-configs, framework-language, database
workflow-quality, security, research-apis
business-content, operator-workflows, social-distribution
media-generation, orchestration, swift-apple
agentic-patterns, devops-infra, supply-chain-domain, document-processing

新增语言支持

Rules 新增：java, kotlin, dart, csharp, cpp, rust, perl, php, web, zh (中文)

Skill 放置策略 (新规范)

仓库新增 docs/SKILL-PLACEMENT-POLICY.md，明确 4 类 skill 的放置位置和归属：

类型	路径	提交仓库	provenance
Curated（人工策划）	`skills/` (repo)	✅	用 frontmatter `origin` 字段
Learned（`/learn` 自动产出）	`~/.claude/skills/learned/`	❌	必须 `.provenance.json`
Imported（外部导入）	`~/.claude/skills/imported/`	❌	必须 `.provenance.json`
Evolved（instinct 聚类产出）	`~/.claude/homunculus/evolved/skills/`	❌	继承自源 instinct

.provenance.json 必填字段：source、created_at、confidence (0-1)、author。

实操含义：

/learn 学到的 skill 自动落到 ~/.claude/skills/learned/ —— 不要手动提交进 repo
validate-skills.js 只校验 skills/ 下的 curated skill，忽略其他三类
跨项目分享走 /instinct-export + /instinct-import，不直接 copy 文件

详见 docs/SKILL-PLACEMENT-POLICY.md。

Token 优化新基线

仓库 docs/token-optimization.md 当前推荐配置：

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL=haiku 是新的省钱大头，子 agent 跑 Haiku 比默认便宜约 80%
⚠️ CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 已被官方警告弃用 —— 该变量在新版 Claude Code 上只能让压缩更早触发，与延后目的相反，移除即可
memory MCP 默认装但无 skill/agent/hook 引用 → 项目级 disabledMcpServers 关掉

精选 Skills（curated subset，非全量）

实际 skills 总数 ~183（v1.10.0）。以下只列最常用的按领域分组。完整清单：ls skills/ 或看 docs/COMMAND-AGENT-MAP.md。

编排三件套（本文档重点）

Skill	用途	Windows 可用
`dmux-workflows`	tmux pane 多 agent 并行	❌（需 WSL）
`autonomous-agent-harness`	自主循环 / 定时 / 持久记忆	✅
`claude-devfleet`	DAG 式多 worker + 独立 worktree + 自动 merge	✅（需本地 DevFleet MCP）

其它相关：autonomous-loops、continuous-agent-loop、ralphinho-rfc-pipeline、council、gan-style-harness。

核心基础设施 (9)

Skill	用途
`agent-harness-construction`	设计 AI agent 动作空间、工具定义和观测格式
`agentic-engineering`	eval-first 执行、任务分解、成本感知路由
`ai-first-engineering`	AI 优先工程运营模式
`continuous-agent-loop`	持续自主 agent 循环，含质量门控和恢复
`enterprise-agent-ops`	长期运行 agent 运维：可观测性、安全边界
`strategic-compact`	逻辑断点手动压缩上下文
`eval-harness`	评估驱动开发(EDD)，pass@k 和 pass^k
`verification-loop`	综合验证：构建、lint、测试、安全扫描
`configure-ecc`	交互式安装向导

开发工作流 (7)

Skill	用途
`autonomous-loops`	顺序管道到 RFC 驱动多 agent DAG
`continuous-learning`	从 session 自动提取可复用模式
`continuous-learning-v2`	instinct 学习系统，带置信度评分
`ralphinho-rfc-pipeline`	RFC 驱动多 agent DAG 执行
`nanoclaw-repl`	零依赖 session 感知 REPL
`tdd-workflow`	Red-Green-Refactor，80%+ 覆盖率
`search-first`	先搜索现有工具/库再编码

前端 (4)

Skill	用途
`frontend-patterns`	React/Next.js 模式、状态管理
`frontend-slides`	动画 HTML 演示文稿
`swiftui-patterns`	SwiftUI 架构、@Observable
`liquid-glass-design`	iOS 26 Liquid Glass 设计系统

后端 & API (5)

Skill	用途
`backend-patterns`	Node.js/Express/Next.js 服务端架构
`api-design`	REST API 设计模式
`cost-aware-llm-pipeline`	LLM API 成本优化和模型路由
`content-hash-cache-pattern`	SHA-256 内容哈希缓存
`iterative-retrieval`	渐进式上下文检索

数据库 (3)

Skill	用途
`postgres-patterns`	PostgreSQL 查询优化、索引、Schema
`clickhouse-io`	ClickHouse 分析数据库
`database-migrations`	Schema 变更、零停机部署

Python + Django (6)

Skill	用途
`python-patterns`	PEP 8、类型提示、Pythonic 惯用法
`python-testing`	pytest、TDD、fixtures、mock
`django-patterns`	Django/DRF 架构、ORM
`django-tdd`	pytest-django、factory_boy
`django-security`	认证、CSRF、SQL 注入防护
`django-verification`	Django 验证循环

Java/Spring Boot (6)

Skill	用途
`java-coding-standards`	命名、不可变性、Optional、Stream
`jpa-patterns`	实体设计、关联、查询优化
`springboot-patterns`	Spring Boot 架构、REST API
`springboot-tdd`	JUnit 5、Mockito、Testcontainers
`springboot-security`	Spring Security 加固
`springboot-verification`	构建、静态分析、覆盖率

Go (2)

Skill	用途
`golang-patterns`	惯用 Go 模式、并发
`golang-testing`	表驱动测试、benchmark、fuzz

C++ (2)

Skill	用途
`cpp-coding-standards`	C++ Core Guidelines
`cpp-testing`	GoogleTest + CMake/CTest

Swift (3)

Skill	用途
`swift-concurrency-6-2`	Swift 6.2 单线程默认 + @concurrent
`swift-actor-persistence`	Actor 线程安全持久化
`swift-protocol-di-testing`	协议注入测试模式

测试 & 质量 (3)

Skill	用途
`e2e-testing`	Playwright E2E、Page Object Model
`plankton-code-quality`	写时质量门控
`skill-stocktake`	Skill 质量审计

部署 (3)

Skill	用途
`deployment-patterns`	CI/CD、回滚、生产就绪检查
`docker-patterns`	Docker Compose、容器安全
`foundation-models-on-device`	Apple FoundationModels 端侧 LLM

安全 & 代码规范 (5)

Skill	用途
`security-review`	认证、输入、secrets 安全检查表
`security-scan`	AgentShield 102 条规则扫描
`coding-standards`	TypeScript/JS/React/Node.js 规范
`regex-vs-llm-structured-text`	正则 vs LLM 解析选择框架
`project-guidelines-example`	项目 skill 模板

内容 & 商业 (5)

Skill	用途
`article-writing`	长文写作
`content-engine`	多平台内容系统
`market-research`	竞争分析、行业情报
`investor-materials`	融资材料
`investor-outreach`	投资者沟通邮件

特殊用途 (2)

Skill	用途
`visa-doc-translate`	签证文档双语翻译 PDF
`nutrient-document-processing`	Nutrient DWS API 文档处理

精选 Agents（非全量）

实际 agents 总数 ~48。以下是最常被命令调用或主代理手动 spawn 的核心子代理。完整清单：ls agents/ 或看 docs/COMMAND-AGENT-MAP.md。

Agent	职责
`planner`	功能实现规划
`architect`	系统设计决策
`tdd-guide`	测试驱动开发
`code-reviewer`	代码质量审查
`security-reviewer`	安全漏洞分析
`build-error-resolver`	编译/运行时错误修复
`e2e-runner`	Playwright E2E 测试
`refactor-cleaner`	死代码清理
`doc-updater`	文档更新
`go-reviewer`	Go 代码审查
`go-build-resolver`	Go 构建错误修复
`python-reviewer`	Python 代码审查
`database-reviewer`	PostgreSQL 审查
`chief-of-staff`	多渠道通信管理
`harness-optimizer`	Agent 框架优化
`loop-operator`	循环任务运维

常用 Commands

开发核心

/plan /tdd /e2e /code-review /build-fix /verify /test-coverage /refactor-clean /feature-dev

PRP 工作流（PRD→实施→PR 一条龙）

/prp-prd /prp-plan /prp-implement /prp-commit /prp-pr

多 Agent 编排

/multi-plan /multi-workflow /multi-execute /multi-frontend /multi-backend /devfleet /orchestrate（legacy shim）

GSD 项目生命周期（独立子插件）

/gsd:new-project /gsd:plan-phase /gsd:execute-phase /gsd:verify-work /gsd:next /gsd:autonomous /gsd:ship /gsd:complete-milestone

学习演化

/learn /learn-eval /evolve /instinct-status /instinct-export /instinct-import /skill-create /skill-health /rules-distill

循环/自动化

/loop-start /loop-status /model-route /quality-gate /harness-audit /promote /claw

验证 & 会话

/checkpoint(verification-loop 检查点)/verify(完整验证管道)/sessions(会话历史)/security-scan(AgentShield 扫描)

REPL & 工具

/claw(NanoClaw REPL，模型路由 + 技能热加载 + 会话分支)/projects(continuous-learning v2 项目管理)/setup-pm(包管理器配置)

完整命令 → agent 映射见仓库 docs/COMMAND-AGENT-MAP.md。

Hooks 系统

PreToolUse

tmux 自动启动和提醒
git push 前 review 提醒
文档文件警告
逻辑断点压缩建议
持续学习观察（异步）

PostToolUse

PR 创建日志
质量门控检查
自动格式化 (Prettier/Biome)
TypeScript 类型检查
console.log 警告

Stop

console.log 最终检查
Session 状态持久化
模式提取评估
Token 成本追踪

控制

ECC_HOOK_PROFILE=standard   # minimal/standard/strict
ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

Resources

Everything Claude Code 方法论与最佳实践
Everything Claude Code 用法速查 <<<<<<< HEAD
ECC 编排实战手册 — 6 种编排模式真实命令 + 实战搭配 + 来源标注 =======
ECC 编排替代方案 (orchestrate 迁移) ← 编排机制全景表

origin/main

16 KiB Raw Blame History Unescape Escape