.claude/skills/{language}-guidelines/
├── SKILL.md
└── references/
    ├── naming.md
    ├── constants.md
    ├── code-format.md
    ├── oop.md
    ├── functional.md
    ├── coding-style.md
    ├── error-handling.md
    ├── logging.md
    ├── testing.md
    ├── concurrency.md
    ├── performance.md
    ├── security.md
    ├── database.md
    ├── api.md
    └── project-structure.md

---
name: {language}-guidelines
description: {语言名称} 编码规范最佳实践。涵盖命名约定、代码格式、错误处理、日志规范、测试规范、性能优化、安全规范等。当编写 {语言} 代码或进行代码审查时使用。
metadata:
  author: {作者}
  version: "1.0"
  compatibility: {兼容版本}
---

# {语言名称} 编码规范

> 版本: 1.0 | 更新: {日期}
>
> {规范来源说明}

---

## 概述

{规范适用场景和目标说明}

### 技术栈

| 组件 | 版本 | 说明 |
|------|------|------|
| {语言/框架} | {版本} | {说明} |

## 必须说明（三要素）

- 做了什么：{一句话说明该规范 Skill 提供的能力}
- 为什么需要：{一句话说明它解决的痛点或风险}
- 什么时候必须用：{列出必须使用的具体场景/条件}

---

## 何时使用此 Skill

| 场景 | 触发词 |
|------|--------|
| 编写代码 | 写 {语言}、写函数、写类 |
| 命名咨询 | 怎么命名、变量名、函数名 |
| 代码审查 | 审查代码、code review |
| 最佳实践 | 最佳实践、规范、标准写法 |

---

## 快速参考

### 核心规范速查

| 规范 | 要点 |
|------|------|
| **命名** | {命名规则要点} |
| **格式** | {格式规则要点} |
| **错误处理** | {错误处理要点} |
| **日志** | {日志规则要点} |

### 禁止项速查

| ❌ 禁止 | ✅ 正确做法 |
|--------|-----------|
| {禁止项} | {正确做法} |

---

## 详细规范目录

| 主题 | 文件 | 内容概要 |
|------|------|---------|
| **命名规范** | [naming.md](references/naming.md) | {概要} |
| **代码格式** | [code-format.md](references/code-format.md) | {概要} |
| ... | ... | ... |

---

## 代码评审 Checklist

### 必查项

| 检查点 | 说明 |
|--------|------|
| **命名规范** | 是否符合命名规则 |
| **代码格式** | 是否符合格式要求 |
| **错误处理** | 是否正确处理错误 |
| **日志规范** | 是否有必要的日志 |
| **测试覆盖** | 是否有单元测试 |

---

## 版本历史

| 版本 | 日期 | 变更 |
|------|------|------|
| 1.0 | {日期} | 初始版本 |

# 命名规范

> {语言} 编码规范 - 命名约定

---

## 基本规则（强制）

### 命名禁则

| 规则 | 说明 | 示例 |
|------|------|------|
| {规则1} | {说明} | ❌ {反例} |
| {规则2} | {说明} | ❌ {反例} |

### 命名风格

| 类型 | 风格 | 示例 |
|------|------|------|
| 变量 | {风格} | `{示例}` |
| 函数/方法 | {风格} | `{示例}` |
| 常量 | {风格} | `{示例}` |
| 类/结构体 | {风格} | `{示例}` |
| 包/模块 | {风格} | `{示例}` |

---

## 详细规则

### 变量命名

{详细规则和示例}

### 函数/方法命名

{详细规则和示例}

### 类/结构体命名

{详细规则和示例}

---

## 命名禁则速查

| ❌ 禁止 | ✅ 正确 | 原因 |
|--------|--------|------|
| {禁止项} | {正确} | {原因} |

**【级别】规范内容描述**

> 说明：对规范的解释和扩展说明

```{语言}
// ❌ 反例 - {反例说明}
{反例代码}

// ✅ 正例 - {正例说明}
{正例代码}

### 3. 表格速查

每个规范文件末尾应有禁则速查表：

```markdown
## 禁则速查

| ❌ 禁止 | ✅ 正确 | 原因 |
|--------|--------|------|
| {禁止项} | {正确做法} | {原因} |

---

## 参考资料

| 来源 | 说明 |
|------|------|
| [阿里巴巴 Java 开发手册](链接) | 编程规约、异常日志、单元测试等 |
| [Google {语言} Style Guide](链接) | 官方风格指南 |
| [Effective {语言}](链接) | 最佳实践书籍 |