everything-claude-code

name	everything-claude-code
description	everything-claude-code 的开发约定和模式。使用 Conventional Commits 的 JavaScript 项目。

Everything Claude Code 约定

从 affaan-m/everything-claude-code 生成于 2026-03-20

概述

此技能向 Claude 教授 everything-claude-code 中使用的开发模式和约定。

技术栈

• 主要语言：JavaScript
• 架构：混合模块组织
• 测试位置：独立

何时使用此技能

在以下情况下激活此技能：

• 对此仓库进行更改
• 按照既定模式添加新功能
• 编写符合项目约定的测试
• 创建具有正确消息格式的提交

提交约定

遵循基于 500 个分析提交的这些提交消息约定。

提交风格：Conventional Commits

使用的前缀

• fix
• test
• feat
• docs

消息指南

• 平均消息长度：约 65 个字符
• 保持第一行简洁且具有描述性
• 使用祈使语气（"Add feature" 而非 "Added feature"）

提交消息示例

feat(rules): add C# language support

提交消息示例

chore(deps-dev): bump flatted (#675)

提交消息示例

fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)

提交消息示例

docs: add Antigravity setup and usage guide (#552)

提交消息示例

merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer

提交消息示例

Revert "Add Kiro IDE support (.kiro/) (#548)"

提交消息示例

Add Kiro IDE support (.kiro/) (#548)

提交消息示例

feat: add block-no-verify hook for Claude Code and Cursor (#649)

架构

项目结构：单一包

此项目使用 混合 模块组织。

配置文件

• .github/workflows/ci.yml
• .github/workflows/maintenance.yml
• .github/workflows/monthly-metrics.yml
• .github/workflows/release.yml
• .github/workflows/reusable-release.yml
• .github/workflows/reusable-test.yml
• .github/workflows/reusable-validate.yml
• .opencode/package.json
• .opencode/tsconfig.json
• .prettierrc
• eslint.config.js
• package.json

指南

• 此项目使用混合组织
• 添加新代码时遵循现有模式

代码风格

语言：JavaScript

命名约定

元素	约定
文件	camelCase
函数	camelCase
类	PascalCase
常量	SCREAMING_SNAKE_CASE

导入风格：相对导入

导出风格：混合风格

首选导入风格

// 使用相对导入
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'

测试

测试框架

未检测到特定测试框架 — 使用仓库的现有测试模式。

文件模式：*.test.js

测试类型

• 单元测试：单独测试单个函数和组件
• 集成测试：测试多个组件/服务之间的交互

覆盖率

此项目配置了覆盖率报告。目标是 80% 以上的覆盖率。

错误处理

错误处理风格：Try-Catch 块

标准错误处理模式

try {
  const result = await riskyOperation()
  return result
} catch (error) {
  console.error('Operation failed:', error)
  throw new Error('User-friendly message')
}

常见工作流

这些工作流是从分析提交模式中检测到的。

数据库迁移

带有迁移文件的数据库架构更改

频率：约每月 2 次

步骤：

1. 创建迁移文件
2. 更新架构定义
3. 生成/更新类型

通常涉及的文件：

• **/schema.*
• migrations/*

示例提交序列：

feat: implement --with/--without selective install flags (#679)
fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
feat(rules): add Rust language rules (rebased #660) (#686)

功能开发

标准功能实现工作流

频率：约每月 22 次

步骤：

1. 添加功能实现
2. 为功能添加测试
3. 更新文档

通常涉及的文件：

• manifests/*
• schemas/*
• **/*.test.*
• **/api/**

示例提交序列：

feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty

添加语言规则

向规则系统添加新的编程语言，包括编码风格、钩子、模式、安全和测试指南。

频率：约每月 2 次

步骤：

1. 在 rules/{language}/ 下创建新目录
2. 添加包含特定语言内容的 coding-style.md、hooks.md、patterns.md、security.md 和 testing.md 文件
3. 可选地引用或链接到相关技能

通常涉及的文件：

• rules/*/coding-style.md
• rules/*/hooks.md
• rules/*/patterns.md
• rules/*/security.md
• rules/*/testing.md

示例提交序列：

Create a new directory under rules/{language}/
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
Optionally reference or link to related skills

添加新技能

向系统添加新技能，记录其工作流、触发器和用法，通常带有支持脚本。

频率：约每月 4 次

步骤：

1. 在 skills/{skill-name}/ 下创建新目录
2. 添加带有文档的 SKILL.md（何时使用、如何工作、示例等）
3. 可选地在 skills/{skill-name}/scripts/ 下添加脚本或支持文件
4. 处理审查反馈并迭代文档

通常涉及的文件：

• skills/*/SKILL.md
• skills/*/scripts/*.sh
• skills/*/scripts/*.js

示例提交序列：

Create a new directory under skills/{skill-name}/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/
Address review feedback and iterate on documentation

添加新 Agent

向系统添加新 agent，用于代码审查、构建解决或其他自动化任务。

频率：约每月 2 次

步骤：

1. 在 agents/{agent-name}.md 下创建新 agent markdown 文件
2. 在 AGENTS.md 中注册 agent
3. 可选地更新 README.md 和 docs/COMMAND-AGENT-MAP.md

通常涉及的文件：

• agents/*.md
• AGENTS.md
• README.md
• docs/COMMAND-AGENT-MAP.md

示例提交序列：

Create a new agent markdown file under agents/{agent-name}.md
Register the agent in AGENTS.md
Optionally update README.md and docs/COMMAND-AGENT-MAP.md

添加新工作流表面

添加或更新工作流入口点。默认技能优先；仅当仍然需要旧式斜杠兼容性时才添加命令填充。

频率：约每月 1 次

步骤：

1. 在 skills/{skill-name}/SKILL.md 下创建或更新规范工作流
2. 仅在需要时，添加或更新 commands/{command-name}.md 作为兼容性填充

通常涉及的文件：

• skills/*/SKILL.md
• commands/*.md（仅当故意保留旧式填充时）

示例提交序列：

Create or update the canonical skill under skills/{skill-name}/SKILL.md
Only if needed, add or update commands/{command-name}.md as a compatibility shim

同步目录计数

将 AGENTS.md 和 README.md 中记录的 agent、技能和命令计数与实际仓库状态同步。

频率：约每月 3 次

步骤：

1. 更新 AGENTS.md 中的 agent、技能和命令计数
2. 更新 README.md 中的相同计数（快速入门、比较表等）
3. 可选地更新其他文档文件

通常涉及的文件：

• AGENTS.md
• README.md

示例提交序列：

Update agent, skill, and command counts in AGENTS.md
Update the same counts in README.md (quick-start, comparison table, etc.)
Optionally update other documentation files

添加跨 Harness 技能副本

为不同的 agent harness（例如 Codex、Cursor、Antigravity）添加技能副本，以确保跨平台兼容性。

频率：约每月 2 次

步骤：

1. 将 SKILL.md 复制或调整到 .agents/skills/{skill}/SKILL.md 和/或 .cursor/skills/{skill}/SKILL.md
2. 可选地添加特定于 harness 的 openai.yaml 或配置文件
3. 处理审查反馈以与 CONTRIBUTING 模板对齐

通常涉及的文件：

• .agents/skills/*/SKILL.md
• .cursor/skills/*/SKILL.md
• .agents/skills/*/agents/openai.yaml

示例提交序列：

Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
Optionally add harness-specific openai.yaml or config files
Address review feedback to align with CONTRIBUTING template

添加或更新钩子

添加或更新 git 或 bash 钩子以执行工作流、质量或安全策略。

频率：约每月 1 次

步骤：

1. 在 hooks/ 或 scripts/hooks/ 中添加或更新钩子脚本
2. 在 hooks/hooks.json 或类似配置中注册钩子
3. 可选地在 tests/hooks/ 中添加或更新测试

通常涉及的文件：

• hooks/*.hook
• hooks/hooks.json
• scripts/hooks/*.js
• tests/hooks/*.test.js
• .cursor/hooks.json

示例提交序列：

Add or update hook scripts in hooks/ or scripts/hooks/
Register the hook in hooks/hooks.json or similar config
Optionally add or update tests in tests/hooks/

处理审查反馈

通过更新文档、脚本或配置来解决代码审查反馈，以提高清晰度、正确性或约定对齐。

频率：约每月 4 次

步骤：

1. 编辑 SKILL.md、agent 或命令文件以解决审查者评论
2. 根据要求更新示例、标题或配置
3. 迭代直到所有审查反馈得到解决

通常涉及的文件：

• skills/*/SKILL.md
• agents/*.md
• commands/*.md
• .agents/skills/*/SKILL.md
• .cursor/skills/*/SKILL.md

示例提交序列：

Edit SKILL.md, agent, or command files to address reviewer comments
Update examples, headings, or configuration as requested
Iterate until all review feedback is resolved

最佳实践

基于代码库分析，遵循这些实践：

应该做

• 使用约定式提交格式（feat:、fix: 等）
• 遵循 *.test.js 命名模式
• 对文件名使用 camelCase
• 优先使用混合导出

不应该做

• 不要编写模糊的提交消息
• 不要跳过新功能的测试
• 未经讨论不要偏离既定模式

---

此技能由 ECC Tools 自动生成。根据您的团队需要审查和定制。