{
  "ocm": "1",
  "id": "jackjin1997-clawforge-clean-code-zh",
  "kind": "skill",
  "name": "clean-code-zh",
  "description": "遵循 Robert C. Martin 的《代码整洁之道》原则，进行代码审查、重构和编写。涵盖命名、函数、注释和错误处理的最佳实践。",
  "publisher": "jackjin1997",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "clean-code",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "遵循 Robert C. Martin 的《代码整洁之道》原则，进行代码审查、重构和编写。涵盖命名、函数、注释和错误处理的最佳实践。"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jackjin1997/clawforge",
      "path": "skills/clean-code-zh/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jackjin1997/clawforge/blob/HEAD/skills/clean-code-zh/SKILL.md",
      "key": "jackjin1997/clawforge/skills/clean-code-zh/SKILL.md"
    }
  },
  "instructions": "# 代码整洁之道 (Clean Code)\n\n本技能赋能 AI Agent 编写、审查和重构符合 **Robert C. Martin (Uncle Bob)**《代码整洁之道》原则的代码。其核心目标是提高代码的可读性、可维护性和长期生产力。\n\n## 核心原则\n\n### 1. 有意义的命名\n- **名副其实**：变量、函数或类的名称应说明其存在的意义、功能以及用法。\n- **避免误导**：避免使用具有特定编程含义的词（如 `accountList` 除非它真的是 `List`）。\n- **做有意义的区分**：避免使用 `data1`, `data2` 或 `theMessage` 这样模糊的命名。\n- **使用读得出来的名称**：避免使用缩写（如 `genymdhms` -> `generationTimestamp`）。\n- **使用可搜索的名称**：单字母变量仅限用于短小的循环内部。\n\n### 2. 函数\n- **短小**：函数的第一条规则是短小。第二条规则是还要更短小。\n- **只做一件事**：函数应该做一件事，做好这件事，且只做这一件事。\n- **每个函数一个抽象层级**：确保函数内的语句都在同一抽象层级上。\n- **函数参数**：最理想的参数数量是 0，其次是 1，再次是 2。尽量避免 3 个及以上参数。\n- **无副作用**：函数不应在暗地里修改全局变量或对象状态。\n-",
  "cost": {
    "context_tokens": 369
  }
}