claude init inited
This commit is contained in:
49
.claude/rules/common/baserule.md
Normal file
49
.claude/rules/common/baserule.md
Normal file
@@ -0,0 +1,49 @@
|
||||
## 语言约定
|
||||
|
||||
Agent 回复时使用简体中文。
|
||||
代码注释时尽量使用简体中文。
|
||||
写 SKILL 的时候文档部分也尽量使用简体中文。
|
||||
专业术语和项目专有名词不受此语言限制,通常是英文则保留(如 `frontmatter`、`hook`、`token`、`MCP`、`Claude Code`、`GitHub` 等)。
|
||||
|
||||
## Rules / Skills 目录归属约定
|
||||
|
||||
本项目使用以下目录结构区分跨项目通用内容与项目专属内容:
|
||||
|
||||
### Rules
|
||||
|
||||
| 目录 | 用途 | 示例 |
|
||||
|------|------|------|
|
||||
| `.claude/rules/common/` | 跨项目通用规则,开新项目时可直接复制 | 语言约定、init 触发、changelog 调用 |
|
||||
| `.claude/rules/project/` | 当前项目专属规则 | 项目架构约定、框架特定规范、项目专属工作流 |
|
||||
|
||||
Rules 的引入通过主 `CLAUDE.md` 的 `@import` 语法进行,每条规则独立一个文件。
|
||||
|
||||
### Skills
|
||||
|
||||
| 位置 | 用途 | 示例 |
|
||||
|------|------|------|
|
||||
| `.claude/skills/` | **所有 Skill 的主存储位置**(含通用和项目专属) | claude-init、dev-changelog、项目特定 Skill |
|
||||
| `~/.claude/skills/` | 跨项目通用 Skill 的全局副本(可选,方便其他项目复用) | claude-init、dev-changelog |
|
||||
|
||||
> **重要**:无论 Skill 是通用还是项目专属,都**必须**在项目的 `.claude/skills/` 下保留一份,
|
||||
> 以确保能被 Git 管理和版本控制。全局目录 `~/.claude/skills/` 仅作为跨项目共享的便利副本,
|
||||
> 不作为唯一存储位置。
|
||||
|
||||
### Agent 创建 Rule 或 Skill 时必须遵守
|
||||
|
||||
1. **先判断归属**:新建 Rule 或 Skill 前,评估其是否为跨项目通用内容
|
||||
2. **如果不确定,必须询问用户**:"这个 Rule/Skill 是通用的还是项目专属的?"
|
||||
3. 确认后放入对应目录:
|
||||
- 通用 Rule → `.claude/rules/common/<name>.md` + 在 `CLAUDE.md` 的"引入的规则"段追加 `@import`
|
||||
- 项目专属 Rule → `.claude/rules/project/<name>.md` + 在 `CLAUDE.md` 的"项目专属规则"段追加 `@import`
|
||||
- **所有 Skill(含通用)→ `.claude/skills/<skill-name>/SKILL.md`**(必须,确保 Git 可管理)
|
||||
- 通用 Skill 额外同步 → `~/.claude/skills/<skill-name>/SKILL.md`(可选,方便其他项目使用)
|
||||
|
||||
### Skill 的 frontmatter 规范
|
||||
|
||||
新建 Skill 时 `SKILL.md` 的 YAML frontmatter 必须符合 Claude Code 官方规范:
|
||||
|
||||
- `name`: 最多 64 字符,仅小写字母/数字/连字符,不含保留词 `anthropic` 或 `claude`
|
||||
- `description`: 最多 1024 字符,非空,**第三人称**,包含"做什么 + 何时使用"的触发关键词
|
||||
|
||||
详见 Anthropic 官方文档:<https://code.claude.com/docs/en/skills>
|
||||
Reference in New Issue
Block a user