Claude Code 在项目中的实践

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

claude --version

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "你的 API 地址", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

{
  "statusLine": {
    "type": "command",
    "command": "bun x ccusage statusline"
  }
}

---
name: your-sub-agent-name
description: Description of when this subagent should be invoked
tools: tool1, tool2, tool3  # Optional - inherits all tools if omitted
---

Your subagent's system prompt goes here. This can be multiple paragraphs
and should clearly define the subagent's role, capabilities, and approach
to solving problems.

Include specific instructions, best practices, and any constraints
the subagent should follow.

/agents

# 创建项目子代理
mkdir -p .claude/agents
echo '---
name: test-runner
description: Use proactively to run tests and fix failures
---

You are a test automation expert. When you see code changes, proactively run the appropriate tests. If tests fail, analyze the failures and fix them while preserving the original test intent.' > .claude/agents/test-runner.md

# 创建用户子代理
mkdir -p ~/.claude/agents
# ... 创建子代理文件

> 使用测试运行器子代理修复失败的测试
> 让代码审查员子代理查看我最近的更改
> 请调试器子代理调查这个错误

# 方案一：从 PyPI 安装（推荐）
pip install SuperClaude
SuperClaude install --quick

# 方案二：从源码安装
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
pip install .
SuperClaude install --quick

# 方案三：使用 UV 安装
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install SuperClaude
SuperClaude install --quick

# 基础功能测试
/sc:help                    # 查看可用命令
/sc:analyze README.md       # 分析项目
/sc:build                   # 智能构建
/sc:improve messy-code.js   # 代码改进

# 新项目理解
/sc:load --deep --summary         # 加载项目上下文
/sc:analyze --focus architecture   # 架构分析
/sc:analyze --focus quality        # 质量评估

# 功能开发
/sc:workflow feature-prd.md        # 从PRD生成工作流
/sc:implement user-auth             # 实现用户认证
/sc:test --coverage                 # 测试验证

# 安全审查
/sc:analyze auth-system/ --focus security  # 自动激活安全专家
/sc:improve auth/ --safe-mode --validate    # 安全改进

# 前端开发 → 自动激活前端专家 + Magic MCP + Context7
/sc:build react-dashboard/

# 安全分析 → 自动激活安全专家 + Sequential MCP + 验证标志
/sc:analyze auth-system/ --focus security  

# 性能调查 → 自动激活性能专家 + 分析专家 + Playwright MCP
/sc:troubleshoot "API responses are slow"

# 从简单开始
/sc:analyze component.js

# 需要时增加复杂性
/sc:analyze component.js --think

# 涉及外部库时添加文档
/sc:analyze component.js --think --c7

# 关键代码全面分析
/sc:analyze component.js --think-hard --c7 --seq --validate

# 始终预览重要更改
/sc:improve production-code/ --preview

# 使用安全模式
/sc:improve critical-system/ --safe-mode --validate

# 迭代改进
/sc:improve legacy-code/ --loop --safe-mode

# 高效的大规模分析
/sc:analyze monorepo/ --delegate auto --uc --focus architecture

# 系统性改进
/sc:improve legacy-system/ --wave-mode auto --safe-mode

# 并行处理
/sc:analyze enterprise-app/ --delegate folders --concurrency 3

### 🔄 项目意识与上下文
- 在新对话开始时**总是阅读 PLANNING.md** 了解项目架构、目标、风格和约束
- 在开始新任务前**检查 TASK.md**
- **使用一致的命名约定、文件结构和架构模式**

### 🧱 代码结构与模块化
- **绝不创建超过500行代码的文件**
- **将代码组织到明确分离的模块中**
- **使用清晰、一致的导入**

### 🧪 测试与可靠性
- **为新功能始终创建 Pytest 单元测试**
- **测试应位于 /tests 文件夹中**
- 至少包括：预期使用测试、边缘情况、失败情况

### ✅ 任务完成
- **在 TASK.md 中立即标记已完成的任务**

## FEATURE:
[具体描述你想构建的内容 - 明确功能和需求]

## EXAMPLES:
[列出 examples/ 文件夹中的示例文件并解释如何使用]

## DOCUMENTATION:
[包含相关文档、API 或 MCP 服务器资源的链接]

## OTHER CONSIDERATIONS:
[提及任何注意事项、特定需求或 AI 助手经常遗漏的问题]

ruff check src/new_feature.py --fix  # 自动修复可能的问题
mypy src/new_feature.py              # 类型检查

def test_happy_path():
    """基本功能正常工作"""
    result = new_feature("valid_input")
    assert result.status == "success"

def test_validation_error():
    """无效输入引发验证错误"""
    with pytest.raises(ValidationError):
        new_feature("")

# 启动服务并测试端点
curl -X POST http://localhost:8000/feature \
  -H "Content-Type: application/json" \
  -d '{"param": "test_value"}'

context-engineering-project/
├── .claude/
│   ├── commands/
│   │   ├── generate-prp.md    # 生成综合性 PRP
│   │   └── execute-prp.md     # 执行 PRP 实现功能
│   └── settings.local.json    # Claude Code 权限
├── PRPs/
│   ├── templates/
│   │   └── prp_base.md       # PRP 基础模板
│   └── feature-example.md    # 生成的 PRP 示例
├── examples/                  # 代码示例（关键！）
├── CLAUDE.md                 # AI 助手的全局规则
├── INITIAL.md               # 功能需求模板
└── README.md                # 项目文档

# 确保已安装 Claude Code
claude-code --version

# 如果未安装，参考官方文档安装
# https://docs.anthropic.com/claude-code

# 进入项目目录
cd your-new-project

# 初始化 Claude Code 配置
/init

# 检查生成的 CLAUDE.md 文件
# 根据项目需求自定义规则

# 与 Claude Code 讨论项目架构
/search "project structure best practices for [your-framework]"

# 创建标准目录结构
mkdir -p src/{components,utils,types,tests}
mkdir -p docs examples

# 安装 SuperClaude（如果需要高级功能）
pip install SuperClaude
SuperClaude install --quick

# 测试 SuperClaude 命令
/sc:analyze README.md
/sc:build --preview

# 克隆 Context Engineering 模板
git clone https://github.com/coleam00/context-engineering-intro.git .context-template

# 复制关键文件到项目中
cp .context-template/INITIAL.md ./
cp .context-template/PRPs/templates/prp_base.md ./docs/

# 创建 examples 目录
mkdir -p examples/{components,utils,tests,api}

# 为每个关键目录创建专用 CLAUDE.md
touch src/components/CLAUDE.md
touch src/api/CLAUDE.md
touch tests/CLAUDE.md

# src/components/CLAUDE.md
## React 组件开发规范
- 使用 TypeScript 和 React 18+ 
- 采用函数组件和 Hooks
- 实现无障碍性（WCAG 2.1 AA）
- 包含 Storybook 故事
- 编写 React Testing Library 测试

# 每天开始工作时
/load project-context.md  # 如果使用 Context Engineering

# 功能开发流程
/sc:workflow feature-requirements.md  # 生成工作流
/sc:implement user-authentication      # 实现功能
/sc:test --coverage                   # 测试验证

# 代码质量检查
/sc:analyze --focus quality
/sc:improve --safe-mode

# 安全审查
/sc:analyze --focus security

# 自动生成文档
/sc:document API --format markdown

# 创建开发日志
echo "## $(date): 完成用户认证模块" >> DEVELOPMENT_LOG.md

# 启用 VSCode 状态栏监控
# 配置路径：设置 > Claude Code > 状态栏显示

# 定期性能分析
/sc:analyze --focus performance
/sc:improve --focus performance

# 在 docs/claude-patterns.md 中记录：
## 常用模式
- 组件创建模式
- API 集成模式  
- 测试编写模式
- 错误处理模式

## 项目特定的最佳实践
- [记录你的项目发现的最佳实践]

# 创建团队共享的配置
git add CLAUDE.md src/*/CLAUDE.md examples/
git commit -m "docs: 添加 Claude Code 项目配置和示例"

# 建立团队约定
# 在 README.md 中添加 Claude Code 使用指南

# 通过状态栏或使用情况分析跟踪：
- 代码生成准确率
- 调试问题解决时间
- 代码审查通过率
- 开发任务完成速度

# 根据使用经验调整 CLAUDE.md
# 添加新发现的最佳实践
# 更新示例和模式库

# 评估是否需要升级工具链：
# 基础 → 进阶：添加更多 CLAUDE.md 文件
# 进阶 → 专业：集成 SuperClaude
# 专业 → 企业：采用 Context Engineering