# 项目约定

## 技术栈
- 后端：FastAPI 0.115，async-first
- ORM：SQLAlchemy 2.0（asyncio 风格）
- 测试：pytest + pytest-asyncio，不要用 unittest

## 代码风格
- 不写多行 docstring，每函数最多一行注释
- 错误处理：业务边界 raise 自定义 Exception；不要在 service 层 catch 后吞掉
- 不要新建文件，优先编辑现有文件

## 必须先看的文件
- `app/core/deps.py` — 所有依赖注入入口
- `app/models/base.py` — 所有 model 必须继承 BaseModel

## 禁止
- 任何 `print()` 调试语句
- `from x import *`
- 修改 `migrations/` 下已应用的迁移文件

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ $CLAUDE_FILE_PATHS == *.py ]]; then ruff format $CLAUDE_FILE_PATHS && ruff check --fix $CLAUDE_FILE_PATHS; fi"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"$CLAUDE_TOOL_INPUT\" | grep -qE 'rm -rf|git push --force|drop database' && exit 1 || exit 0"
          }
        ]
      }
    ]
  }
}

---
description: 根据最近的 git 提交生成 CHANGELOG 条目
---

读取从上一个 tag 到 HEAD 的所有 commit（用 `git log <last-tag>..HEAD --oneline`），
按 feat / fix / chore / docs 分类，
按照项目 CHANGELOG.md 的现有格式追加一节。

要求：
- 标题用今天日期 + 版本号（从 package.json 读）
- feat 类要写清"用户能做什么新事"，不要堆 commit message
- breaking change 单独标 ⚠️

---
description: 给指定 PR 写 review 评论
argument-hint: <pr-number>
---

用 `gh pr view $ARGUMENTS --json files,title,body` 获取 PR 内容，
按 review-checklist.md 里的项逐条 review，
找到问题用 `gh pr review $ARGUMENTS --comment -b "..."` 发表评论。

请同时（并行）执行以下三件事：
1. 在 services/ 下找所有调用 `external_api.py` 的位置
2. 在 tests/ 下找所有 mock 了 external_api 的测试
3. 在 docs/ 下找所有提到 external_api 的文档

每件事用一个独立的 Agent 任务，三个并行启动。

# 让 Claude 读 issue 全文
请用 `gh issue view 456 --comments` 看完这个 issue 和所有评论，
然后告诉我应该怎么修。

# 让 Claude 看 CI 失败原因
最近一次 push 的 CI 挂了，用 `gh run list -L 1` 找到 run ID，
然后用 `gh run view <id> --log-failed` 看失败日志，分析原因。

# 让 Claude 分析生产日志
读 `~/var/log/myapp/2026-05-27.log` 最后 500 行，
找出所有 ERROR 级别记录，按出现次数归类。

.claude/skills/new-microservice/
├── SKILL.md              # 描述 + 触发条件
├── templates/
│   ├── pyproject.toml.tpl
│   ├── Dockerfile.tpl
│   └── main.py.tpl
└── scripts/
    └── setup.sh

---
name: new-microservice
description: 在 services/ 下创建符合公司规范的新微服务骨架，包括 FastAPI 入口、Dockerfile、CI 模板。当用户说"新建一个 XX 服务"或"加一个微服务"时使用。
---

按以下步骤：
1. 询问服务名（kebab-case）
2. 复制 templates/ 下所有模板到 services/<服务名>/，替换占位符
3. 跑 scripts/setup.sh 初始化依赖
4. 在 .github/workflows/ 加上对应的 CI 文件

{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(gh issue view *)",
      "Bash(gh pr view *)",
      "Bash(pytest *)",
      "Read(**)",
      "Edit(src/**)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)",
      "Bash(curl * | sh)",
      "Edit(.env*)",
      "Edit(secrets/**)"
    ]
  }
}

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="sk-你的ClaudeAPI密钥"
export ANTHROPIC_BASE_URL="https://gw.claudeapi.com"

# Windows PowerShell（永久）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://gw.claudeapi.com", "User")

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的ClaudeAPI密钥",
    "ANTHROPIC_BASE_URL": "https://gw.claudeapi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}