AgentSkillsCN

code-design

根据6大良好代码设计原则、风格指南与最佳实践，生成项目专属的CLAUDE.md（或AGENTS.md）。当用户请求创建CLAUDE.md、设置代理指令、添加代码设计原则，或初始化编码标准时触发。

SKILL.md
--- frontmatter
name: code-design
description: >
  Generate a project-specific CLAUDE.md (or AGENTS.md) with the 6 Principles of Good Code Design,
  style guides, and best practices. Triggers on requests to create CLAUDE.md, set up agent
  instructions, add code design principles, or initialize coding standards.

Code Design Principles — Agent Skill

You are setting up agent instructions for this project based on the 6 Principles of Good Code Design: Consistent, Correct, Clear, Concise, Simple, Salient.

Step 1: Check for Existing Files

Before writing anything, check if any of these files already exist in the project root:

  • •CLAUDE.md
  • •AGENTS.md
  • •.cursorrules
  • •.github/copilot-instructions.md

If any exist, show the user what was found and ask whether to:

  • •Merge the principles into the existing file
  • •Replace the existing file
  • •Cancel

Do not overwrite without explicit confirmation.

Step 2: Detect Project Stack

Scan the project root for configuration files to determine the stack:

FileStack
package.jsonNode.js / TypeScript / JavaScript
tsconfig.jsonTypeScript
pyproject.tomlPython (modern)
setup.py / setup.cfgPython (legacy)
Cargo.tomlRust
go.modGo
GemfileRuby
pom.xml / build.gradleJava / Kotlin
mix.exsElixir
Package.swiftSwift

Also detect:

  • •Package manager: Look for uv.lock, poetry.lock, pnpm-lock.yaml, yarn.lock, package-lock.json, Pipfile.lock
  • •Test framework: Look for pytest.ini, jest.config.*, vitest.config.*, .mocharc.*, test directories
  • •Linter/formatter: Look for .eslintrc.*, biome.json, ruff.toml, .prettierrc.*, rustfmt.toml

Step 3: Read the Template

Read the CLAUDE.md file located in this skill's directory (next to this SKILL.md file). This is the base template you will customize. For the full rationale behind each principle, see PRINCIPLES.md in the same directory.

Step 4: Generate the Instructions File

Using the template from Step 3, create a CLAUDE.md (or AGENTS.md if the user's agent platform prefers it) in the project root. The template includes Python and TypeScript as examples — adapt the language-specific sections to match the detected stack:

  1. •Style Guide — Replace the Python/TypeScript subsections with idiomatic style entries for the detected language(s).
  2. •Project Setup — Replace with actual setup instructions: package manager commands, build/test/lint scripts found in the project's config files (package.json scripts, Makefile, pyproject.toml, etc.). The Python section in the template shows the level of detail expected.

Step 5: Confirm

After writing the file, tell the user:

  • •What file was created and where
  • •What stack was detected
  • •What sections were customized
  • •Suggest they review and adjust the Project Setup section for any project-specific tooling