Claude Code 最佳实践

# 角色
你是一位资深 [语言] 开发者，专精于 [领域]

# 任务
分析 [文件路径/代码片段] 的 [问题类型]

# 要求
- 识别 [具体问题]
- 解释 [期望了解的内容]
- 提供 [改进建议/解决方案]

# 约束
- 遵循 [代码规范]
- 考虑 [性能/安全/兼容性]

# 背景
[项目介绍 + 当前状态]

# 需求
实现 [功能描述]，包括：
1. [具体功能点 1]
2. [具体功能点 2]

# 技术约束
- 框架: [版本要求]
- 数据库: [如果有]
- API: [风格/RESTful/GraphQL]

# 验收标准
- [测试用例 1]
- [测试用例 2]

# 问题描述
[简要描述 bug 现象]

# 复现步骤
1. [步骤 1]
2. [步骤 2]

# 期望行为
[应该发生什么]

# 实际行为
[实际发生了什么]

# 环境信息
- OS: [系统版本]
- [框架/库] 版本: [版本号]
- 浏览器: [如果是前端]

# 审查范围
[PR/提交/文件的链接或描述]

# 关注点
- [性能优化]
- [安全性检查]
- [代码规范]
- [测试覆盖]

# 团队规范
[相关文档链接或关键规则]

{
  "permissions": {
    "allow": [
      "Bash(npm run test)",
      "Bash(npm run lint)"
    ],
    "deny": [
      "Bash(git push)",
      "Read(./.env)"
    ]
  }
}

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Read(./config/*prod*)"
    ]
  }
}

{
  "permissions": {
    "ask": [
      "Bash(git push)",
      "Bash(rm *)",
      "Bash(drop database)"
    ]
  }
}

# 快速开始对话
claude "帮我 review 这段代码"

# 单次任务执行
claude -p "修复所有 lint 错误"

# 管道集成
cat error.log | claude -p "分析并修复"

# 配置 MCP 服务器
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/github-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
    }
  }
}

# .claude/agents/review-agent.json
{
  "name": "code-reviewer",
  "description": "专业代码审查助手",
  "systemPrompt": "你是一位资深代码审查专家..."
}

# 使用子代理
@code-reviewer 请审查这个 PR

{
  "hooks": [
    {
      "event": "ToolResult",
      "matchers": [{"name": "Bash"}],
      "actions": [
        {
          "type": "shell",
          "command": "echo 'Command executed: ${tool.command}'"
        }
      ]
    }
  ]
}

# 项目开发规范

## 技术栈
- React 18 + TypeScript
- Vite 构建
- TailwindCSS

## 代码规范
- 使用 ESLint + Prettier
- Commit message 遵循 Conventional Commits
- 分支命名: feature/*, bugfix/*

## 测试要求
- 单元测试覆盖率 > 80%
- 集成测试覆盖核心流程