# Node.js（Claude Code 需要）
node --version  # 需要 18+

# Git（版本控制必须）
git --version

# 你的 API Key
# OpenAI / Anthropic / OpenRouter

touch AGENTS.md

# AGENTS.md — 入口文件

## 角色
你是一个 [你的技术栈] 工程师，专注于 [领域]。

## 项目结构
- `src/` — 源代码
- `tests/` — 测试文件
- `docs/` — 文档

## 开发约定
- 代码风格：见 `.eslintrc`
- 提交规范：见 `CONTRIBUTING.md`
- API 设计原则：见 `docs/api-guidelines.md`

## 当前任务状态
[每次开始新任务时更新此section]

## 近期常见错误
[每次 Agent 犯错后，在这里加一条规则]

project/
├── AGENTS.md              # 入口，约100行
├── docs/
│   ├── api-guidelines.md  # API设计详细规范
│   ├── testing-guide.md    # 测试规范
│   └── style-guide.md      # 代码风格详细说明
└── .claude/
    └── settings/          # Agent 配置

# linters/arch_check.py
"""检查Controller不直接调Repository"""
import ast
import sys

class ArchViolation(ast.NodeVisitor):
    def __init__(self, filename):
        self.filename = filename
        self.violations = []
    
    def visit_Call(self, node):
        # 检查是否是 Repository 类的调用
        if isinstance(node.func, ast.Attribute):
            if node.func.attr.endswith('Repository'):
                # 确认调用者不是 Service
                context = getattr(self, 'current_class', '')
                if context and not context.endswith('Service'):
                    self.violations.append(
                        f"{self.filename}:{node.lineno}: "
                        f"Repository直接调用发生在非Service层。"
                        f"应通过Service间接调用。"
                    )
        self.generic_visit(node)

# .pre-commit-config.yaml
repos:
  - repo: local
    hooks:
      - id: architecture-check
        name: Architecture Linter
        entry: python linters/arch_check.py
        language: system
        files: src/.*\.py$

project/
├── AGENTS.md
├── docs/
│   ├── onboarding.md      # 新人上手指南
│   ├── architecture.md   # 架构文档
│   └── runbooks/          # 运维手册
├── scripts/
│   └── setup.sh          # 环境搭建脚本
└── .env.example          # 环境变量示例

# AGENTS.md（主入口）

## 项目概览
[50行项目基本信息]

## 开发指南
详见 [docs/dev-guide.md](docs/dev-guide.md)

## 测试要求
详见 [docs/testing.md](docs/testing.md)

## 近期变更
详见 [.claude/changelog.md](.claude/changelog.md)

# progress.md

## 当前任务
- 用户认证模块重构

## 已完成
- [x] 设计认证流程
- [x] 实现 JWT 生成
- [ ] 实现 Refresh Token 轮转

## 障碍
- 暂无

## 下一步
1. 实现 Refresh Token 过期逻辑
2. 添加单元测试

# 安装 Playwright MCP
npx @anthropic/mcp-server playwight

my-skill/
├── SKILL.md              # 必须：触发条件和核心指令
├── scripts/              # 可选：确定性逻辑
│   └── do_something.py
└── references/          # 可选：详细文档
    └── api_docs.md

---
name: code-review
description: 代码审查Skill。当用户说"审查这段代码"、"帮我review"、"检查有没有bug"时触发。
---

# Code Review Skill

## 快速用法

用 `scripts/review.py`：
```bash
python scripts/review.py --file <文件路径>

## 发现的Issue
1. [严重] 第23行：直接拼接SQL
2. [中等] 第45行：缺少超时处理

## 建议
1. 使用参数化查询
2. 添加 30s 超时

### 4.3 Description 是关键

**Description 决定什么时候触发这个 Skill**。

好例子：

```yaml
description: 代码审查。当用户说"审查这段代码"、"帮我review"、"检查有没有bug"、"review PR"时触发。

description: 这个Skill可以审查代码，支持多种检查。