claude-code-dev

分类: 开发与编程 | 上传者: chatgptprojects | 下载: 0 | 版本: v1.0（最新）

如何按照既定的编程风格、模式和约定来开发、修改和扩展 Claude Code 代码库。在处理 claude 代码源时使用此技能 - 添加工具、命令、实用程序、组件、类型、挂钩、服务或修复错误。当用户询问克劳德代码架构、编码标准、文件组织或想要了解代码库如何工作时也可以使用。这项技能可确保所有贡献都与现有代码库风格完全匹配。

更新日志: Source: GitHub https://github.com/chatgptprojects/clear-code

目录结构

当前层级: tree/main/claude-code-skills/

📄 01-project-overview.md 4.6 KB
📄 02-directory-structure.md 9.1 KB
📄 03-import-conventions.md 9.3 KB
📄 04-naming-conventions.md 10.8 KB
📄 05-typescript-patterns.md 12.3 KB
📄 06-commenting-style.md 14.5 KB
📄 07-error-handling.md 11.2 KB
📄 08-function-patterns.md 12.5 KB
📄 09-tool-architecture.md 13.6 KB
📄 10-command-architecture.md 9.2 KB
📄 11-state-management.md 8.7 KB
📄 12-testing-conventions.md 5.8 KB
📄 13-formatting-rules.md 8.4 KB
📄 14-quick-references.md 9.9 KB
📄 README.md 1.9 KB
📄 SKILL.md 3.2 KB

SKILL.md

---
name: claude-code-dev
description: How to develop, modify, and extend the Claude Code codebase following its established programming style, patterns, and conventions. Use this skill whenever working on the claude-code source — adding tools, commands, utils, components, types, hooks, services, or fixing bugs. Also use when the user asks about claude-code architecture, coding standards, file organization, or wants to understand how the codebase works. This skill ensures all contributions match the existing codebase style exactly.
---

# Claude Code Development Style Guide

This skill captures the programming style, patterns, and conventions used in the Claude Code codebase (`@anthropic-ai/claude-code`). Each topic below links to a dedicated deep-dive document with comprehensive examples and rules extracted from the actual source.

## Summary

**Claude Code** is an ESM TypeScript Node.js CLI application using Ink (React for terminals) for its UI, esbuild for transpilation, and Bun internally for feature flags and dead code elimination. Key stack: TypeScript, Zod v4, lodash-es, React/Ink, esbuild.

## Detailed Guides (Resource Files)

Each topic below is covered in depth in its own resource file within this skill's directory. Read the relevant file before working on that area of the codebase.

| # | Topic | File | Summary |
|---|---|---|---|
| 01 | **Project Overview** | `01-project-overview.md` | Tech stack, build system, runtime environment, key dependencies |
| 02 | **Directory Structure** | `02-directory-structure.md` | Full `src/` layout, file organization patterns, where things go |
| 03 | **Import Conventions** | `03-import-conventions.md` | `.js` extensions, `import type`, lodash cherry-picks, feature flags, cycle breaking |
| 04 | **Naming Conventions** | `04-naming-conventions.md` | camelCase/PascalCase/UPPER_SNAKE rules, file naming, safety names |
| 05 | **TypeScript Patterns** | `05-typescript-patterns.md` | Branded types, discriminated unions, `as const`, `satisfies`, Zod schemas, generics |
| 06 | **Commenting Style** | `06-commenting-style.md` | JSDoc, why-not-what philosophy, PR references, section headers, lint suppression |
| 07 | **Error Handling** | `07-error-handling.md` | Custom error classes, utility functions, graceful degradation, catch conventions |
| 08 | **Function Patterns** | `08-function-patterns.md` | `buildTool()` factory, memoize, async generators, guard clauses, fire-and-forget |
| 09 | **Tool Architecture** | `09-tool-architecture.md` | Tool directory structure, `buildTool()` API, schemas, permissions, UI rendering |
| 10 | **Command Architecture** | `10-command-architecture.md` | Command types, index.ts pattern, lazy loading, registration |
| 11 | **State Management** | `11-state-management.md` | Module-level state, getter/setter, AppState threading, cleanup registry |
| 12 | **Testing Conventions** | `12-testing-conventions.md` | Reset helpers, NODE_ENV guards, test-only exports, deterministic sorting |
| 13 | **Formatting Rules** | `13-formatting-rules.md` | No semicolons, single quotes, trailing commas, indentation, expression style |
| 14 | **Quick References** | `14-quick-references.md` | Step-by-step checklists for adding tools, commands, utils, and types |

登录后下载/点赞/收藏 ❤ 1.9K | ★ 0

claude-code-dev

目录结构

SKILL.md

举报内容

提示