mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-14 20:21:23 +08:00
e4a0062d9b
* docs(zh-CN): translate ecc-guide and parallel-execution-optimizer skills Adds Simplified Chinese translations for two untranslated skills, following the existing docs/zh-CN/skills/ conventions (frontmatter name/origin preserved, code blocks and output templates kept in English, prose fully translated). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(zh-CN): polish two phrasings per review Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
5.3 KiB
5.3 KiB
name, description, origin
| name | description | origin |
|---|---|---|
| ecc-guide | 在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。 | community |
ECC 指南
当用户需要帮助来理解、浏览、安装 Everything Claude Code 或在其中做选择时,使用此技能。
何时使用
当用户出现以下情况时使用此技能:
- 询问 ECC 包含哪些内容
- 需要帮助查找某个 skill、命令、agent、hook、规则或安装配置档案
- 刚接触本仓库,需要一条引导路径
- 询问"如何用 ECC 做 X?"
- 询问哪些 ECC 组件适合某个项目
- 需要简单了解命令、skills、agents、hooks 和规则之间的关系
- 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑
核心原则
依据当前文件回答,而不是凭记忆。ECC 变化很快,硬编码的目录数量、功能列表和安装说明都会过时。
当 ECC 仓库可用时,先检查相关文件再给出具体答案:
node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json
只读取回答用户问题所需的最小文件集。
仓库地图
README.md:安装路径、卸载/重置指引、对外定位、常见问题AGENTS.md:贡献者指引和项目结构agent.yaml:导出的 gitagent 接口和命令列表commands/:持续维护的斜杠命令兼容垫片skills/*/SKILL.md:可复用的工作流和领域手册agents/*.md:用于委派的子代理角色提示词rules/:语言规则和运行环境规则hooks/README.md、hooks/hooks.json、scripts/hooks/:hook 行为和安全门控manifests/install-*.json:选择性安装的模块、组件、配置档案和目标支持docs/:运行环境指南、架构笔记、翻译文档、发布文档
回复风格
先给答案,再给下一步动作。大多数用户不需要完整的目录倾倒。
良好的首次回复结构:
- 用什么
- 为什么合适
- 要查看的确切文件或命令
- 一个后续命令或问题
避免:
- 默认列出所有 skill 或命令
- 重复 README 的大段内容
- 在已有 skill 优先路径时仍推荐已退役的命令垫片
- 未检查文件系统就声称某个组件存在
- 在托管安装器支持目标环境时,用手动复制命令代替安装指引
常见任务
新用户入门
给出一份简短菜单:
- 安装或重置 ECC
- 为项目挑选 skills
- 理解命令与 skills 的区别
- 检查 hooks 和安全行为
- 运行一次运行环境审计
- 查找某个特定工作流
安装/重置指向 README.md,项目级接入指向 /project-init。
功能发现
对于"我该用什么来做 X?":
- 搜索
skills/、commands/和agents/。 - 优先把 skills 作为主要工作流入口。
- 仅当命令是持续维护的兼容垫片、或用户明确想要斜杠命令行为时才使用命令。
- 当委派有价值时提及 agents。
有用的搜索:
rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort
安装指引
使用托管安装路径:
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run
针对特定 skill 的安装:
node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run
提醒用户不要同时叠加插件安装和完整的手动/档案安装,除非他们有意要重复的组件面。
项目接入
当用户想为目标仓库配置 ECC 时,使用 /project-init。预期顺序为:
- 从项目文件检测技术栈
- 生成一份 dry-run 安装计划
- 检查现有的
CLAUDE.md和设置文件 - 在应用更改前先询问
- 保持生成的指引精简且针对该仓库
故障排查
先询问目标运行环境和安装路径,然后检查:
- 插件安装元数据
.claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/或.qwen/hooks/hooks.json- 安装状态文件
- 相关的命令/skill 文件
针对仓库健康度,建议:
npm run harness:audit -- --format text
npm run observability:ready
npm test
输出模板
简短推荐
Use <skill-or-command>. It fits because <reason>.
Canonical file: <path>
Verify with: <command>
Next: <one concrete action>
搜索结果
Best matches:
- <path>: <why it matters>
- <path>: <why it matters>
Recommendation: <which one to use first and why>
安装计划摘要
Detected: <stack evidence>
Target: <harness>
Plan: <profile/modules/skills>
Dry run: <command>
Would change: <paths>
Needs approval before apply: <yes/no>
相关入口
/project-init:面向目标仓库的技术栈感知接入计划/harness-audit:确定性的就绪度评分卡/skill-health:skill 质量审查/skill-create:从本地 git 历史生成新 skill/security-scan:检查 Claude/OpenCode 配置安全性