用途
everything-claude-code 是一个用于教导 Claude 掌握 everything-claude-code 仓库开发模式与约定的技能。当需要对该仓库进行修改、按既有模式添加新功能、编写符合项目约定的测试,或创建格式正确的提交信息时,可激活此技能。
主要能力
该技能基于对 500 次提交的分析,提供以下约定信息:
- 提交规范:采用 Conventional Commits,使用的前缀包括 fix、test、feat、docs。平均消息长度约 65 个字符,首行需简洁且具描述性,使用祈使语气(如 "Add feature" 而非 "Added feature")。技能中给出了多个提交消息示例,例如
feat(rules): add C# language support、fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)等。 - 代码风格:主要语言为 JavaScript。命名约定为:文件 camelCase、函数 camelCase、类 PascalCase、常量 SCREAMING_SNAKE_CASE。导入风格为相对导入,导出风格为混合风格。技能中给出了相对导入的示例代码。
- 测试约定:未检测到特定测试框架,建议使用仓库现有的测试模式。文件模式为
*.test.js。测试类型包括单元测试(隔离测试单个函数和组件)和集成测试(测试多个组件/服务之间的交互)。项目配置了覆盖率报告,目标为 80% 以上。 - 错误处理:采用 try-catch 块风格,技能中给出了标准错误处理模式示例。
- 架构信息:项目结构为单一包,使用混合模块组织方式。列出了配置文件,包括多个 GitHub Actions 工作流文件(ci.yml、maintenance.yml、monthly-metrics.yml、release.yml、reusable-release.yml、reusable-test.yml、reusable-validate.yml)、.opencode 下的 package.json 与 tsconfig.json、.prettierrc、eslint.config.js、package.json。
常见工作流
技能从提交模式中检测出以下工作流,并给出步骤与涉及文件:
- 数据库迁移:约每月 2 次。步骤为创建迁移文件、更新 schema 定义、生成/更新类型。涉及文件如
**/schema.*、migrations/*。 - 功能开发:约每月 22 次。步骤为添加功能实现、为功能添加测试、更新文档。涉及文件如
manifests/*、schemas/*、**/*.test.*、**/api/**。 - 添加语言规则:约每月 2 次。在
rules/{language}/下创建新目录,添加 coding-style.md、hooks.md、patterns.md、security.md、testing.md 等语言特定内容文件,可选地引用或链接相关技能。 - 添加新技能:约每月 4 次。在
skills/{skill-name}/下创建新目录,添加 SKILL.md 文档(包含 When to Use、How It Works、Examples 等),可选地在skills/{skill-name}/scripts/下添加脚本或支持文件,处理评审反馈并迭代文档。 - 添加新智能体:约每月 2 次。在
agents/{agent-name}.md创建智能体 markdown 文件,在 AGENTS.md 中注册该智能体,可选地更新 README.md 和 docs/COMMAND-AGENT-MAP.md。 - 添加新工作流入口:约每月 1 次。默认技能优先;仅在仍需旧式斜杠兼容时添加命令 shim。在
skills/{skill-name}/SKILL.md创建或更新规范工作流,仅在需要时添加或更新commands/{command-name}.md作为兼容 shim。 - 同步目录计数:约每月 3 次。更新 AGENTS.md 中智能体、技能和命令的计数,在 README.md 中更新相同计数(快速开始、对比表等),可选地更新其他文档文件。
- 添加跨 harness 技能副本:约每月 2 次。将 SKILL.md 复制或适配到
.agents/skills/{skill}/SKILL.md和/或.cursor/skills/{skill}/SKILL.md,可选地添加 harness 特定的 openai.yaml 或配置文件,处理评审反馈以符合 CONTRIBUTING 模板。 - 添加或更新钩子:约每月 1 次。在
hooks/或scripts/hooks/中添加或更新钩子脚本,在hooks/hooks.json或类似配置中注册钩子,可选地在tests/hooks/中添加或更新测试。 - 处理评审反馈:约每月 4 次。编辑 SKILL.md、智能体或命令文件以处理评审意见,按要求更新示例、标题或配置,迭代直至所有评审反馈解决。
最佳实践
技能基于代码库分析给出以下建议:
- 应做:使用 Conventional Commit 格式(feat:、fix: 等);遵循
*.test.js命名模式;文件名使用 camelCase;偏好混合导出。 - 不应做:不要写含糊的提交消息;不要为新功能跳过测试;未经讨论不要偏离既有模式。
适用场景
适用于在 everything-claude-code 仓库中进行开发、维护和贡献时,让 Claude 遵循项目既定的提交、代码风格、测试、错误处理和工作流约定。
限制
该技能由 ECC Tools 自动生成,建议根据团队需要进行审查和定制。技能中未检测到特定测试框架,需使用仓库现有的测试模式。技能内容基于 2026-03-20 从 affaan-m/everything-claude-code 生成,可能随仓库变化而过时。