项目惯例发现Skill project-conventions

自动发现项目的编码惯例和配置标准,通过分析CLAUDE.md、package.json等配置文件,帮助代理理解项目规范并遵循现有模式。关键词:项目惯例、代码风格、自动化工具、配置管理、CLAUDE、包管理、测试框架、构建配置。

DevOps 0 次安装 0 次浏览 更新于 3/18/2026

name: project-conventions description: 从CLAUDE.md、package.json、linter配置和其他配置文件中发现主机项目的惯例。在代理需要理解目标项目的编码标准时使用。 user-invocable: false

项目惯例发现

发现并报告主机项目的惯例,以便代理遵循现有模式。

使用时机

此技能在代理需要在做出更改之前理解目标项目的惯例时自动调用。它不是用户可调用的。

发现过程

1. 项目身份

查找项目配置:

  • package.json — 名称、脚本、依赖项、引擎
  • pyproject.toml / setup.py — Python项目配置
  • Cargo.toml — Rust项目配置
  • go.mod — Go模块配置
  • build.gradle / pom.xml — Java/Kotlin项目配置

2. Claude代码配置

读取项目级Claude配置:

  • CLAUDE.md — 项目指令和惯例
  • .claude/settings.json — 项目设置
  • .claude/skills/ — 可用技能和命令

3. 代码风格

检查linter和formatter配置:

  • .eslintrc* / eslint.config.* — JavaScript/TypeScript代码检查
  • .prettierrc* — 代码格式化
  • biome.json — Biome配置
  • .editorconfig — 编辑器设置
  • rustfmt.toml — Rust格式化
  • .flake8 / pyproject.toml [tool.ruff] — Python代码检查

4. 测试惯例

识别测试框架和模式:

  • 测试文件位置(__tests__/, *.test.*, *.spec.*, tests/
  • 测试运行器(jest, vitest, pytest, cargo test, go test
  • 覆盖率配置

5. 构建与CI

检查构建和CI设置:

  • Makefile / Justfile — 构建命令
  • .github/workflows/ — CI管道
  • Dockerfile / docker-compose.yml — 容器配置
  • tsconfig.json — TypeScript配置

输出格式

## 项目惯例:{project-name}

### 语言与运行时
- 语言:[语言] [版本]
- 运行时:[运行时] [版本]
- 包管理器:[管理器]

### 代码风格
- 格式化工具:[工具]([配置文件])
- 代码检查工具:[工具]([配置文件])
- 关键规则:[显著规则]

### 测试
- 框架:[框架]
- 测试位置:[模式]
- 运行命令:[命令]

### 构建
- 构建命令:[命令]
- CI:[平台]

### 项目特定规则
- [来自CLAUDE.md的规则,代理必须遵循]