Agent 编程速查手册：客户端、模型与命令

# 一次性
git init                              # 初始化
git clone <url>                       # 克隆远程仓库

# 日常（高频）
git status                            # 看状态
git add .                             # 加入待存档
git commit -m "说明"                  # 存档
git log --oneline                     # 看历史
git diff                              # 看改动

# 回退
git checkout <id>                     # 临时看老版本
git checkout main                     # 回最新
git reset --hard <id>                 # 真回退
git stash                             # 暂存改动
git stash pop                         # 取回暂存

# 分支
git checkout -b <分支名>              # 新建并切换
git branch                            # 看分支
git merge <分支名>                    # 合并
git branch -d <分支名>                # 删分支

# 远程
git remote add origin <url>           # 关联远程
git push -u origin main               # 首次推送
git push                              # 推送
git pull                              # 拉取

# 环境
python3 -m venv venv                  # 建虚拟环境
source venv/bin/activate              # 激活（Mac/Linux）
venv\Scripts\activate                 # 激活（Windows）

# 包管理
pip install <包名>                    # 装
pip install -r requirements.txt       # 批量装
pip freeze > requirements.txt         # 导出依赖
pip list                              # 看已装

# 运行
python3 script.py                     # 跑脚本
python3 -m pytest                     # 跑测试
python3 -m pytest -v                  # 详细模式
python3 -m pytest tests/test_xxx.py   # 跑特定测试

# 初始化
npm init -y                           # 建默认 package.json
npx create-next-app@latest my-app     # 建 Next.js 项目

# 安装
npm install <包名>                    # 本地装
npm install -g <包名>                 # 全局装
npm install                           # 按 package.json 装

# 运行
npm run dev                           # 开发模式
npm run build                         # 构建
npm run start                         # 生产模式

# 测试
npm test                              # 跑测试

# 敏感
.env
*.key
*.pem
credentials.json
secrets/

# Python
__pycache__/
*.pyc
venv/
.pytest_cache/

# Node
node_modules/
.next/
dist/

# 数据
*.csv
*.db
*.sqlite
data/

# 系统
.DS_Store
Thumbs.db

ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
DATABASE_URL=postgres://...
SUPABASE_URL=https://xxx.supabase.co
SUPABASE_ANON_KEY=xxx
GITHUB_TOKEN=ghp_xxx

{
  "permissions": {
    "deny": ["rm -rf *", "git push --force"],
    "ask": ["rm *", "git push *", "npm publish *"]
  }
}

# [项目/任务名] 规格文档

## R：角色与背景
我是 ___，在做 ___。这个项目给 ___ 用。

## F：功能与边界
需要实现：
1. ___
2. ___

边界（不做什么）：
- 不做 ___
- 不做 ___

业务规则：
- ___

## C：验收标准
- ___（具体可验证）
- ___

## 示例数据
输入：___
预期输出：___

# [项目] PLAN.md

## 一句话目标
___

## L2 模块
1. ___
2. ___

## L3 任务清单

### 模块 1
- [ ] 1.1 ___
- [ ] 1.2 ___

### 模块 2
- [ ] 2.1 ___

## 依赖关系
1.x → 2.x → 3.x

## MVP（最小切片）
1.1 + 1.2 + 2.1

## 执行顺序
- [ ] MVP → 测试 → commit
- [ ] 清空对话
- [ ] 下一组 → ...

# [项目] CLAUDE.md

## 1. 一句话说明
___

## 2. 技术栈
- ___

## 3. 项目结构
___（目录树）

## 4. 业务规则
### 数据规则
- ___
### 计算规则
- ___
### 业务常识（验证用）
- ___

## 5. 编码规范
- 命名：___
- 注释：___

## 6. 工作流
- 测试命令：___
- commit 节奏：每个小任务一次

## 7. 红线与常见坑
### 红线
- ___
### 常见坑
- ___

# 小任务验证清单

## 第一层：功能
- [ ] 用 1 组已知数据测试，结果对吗？
- [ ] 跑现有测试，全绿吗？

## 第二层：业务
- [ ] 心算对比，数字合理吗？
- [ ] 关键指标在正常区间吗？

## 第三层：边界
- [ ] 空数据、零值、负值试过吗？
- [ ] 缺失字段处理了吗？
- [ ] 极端值呢？

## 收尾
- [ ] 能用 1 句话说清"做完了"吗？
- [ ] commit 了吗？