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的规则,代理必须遵循]