Step 1：写 AGENTS.md 规则文件（10 分钟）

目标：一套规则，全工具复用。

操作流程：

• 在项目根目录创建 AGENTS.md
• 直接复制下面内容，改不改都行：

# AGENTS.md - 团队协作规则（唯一权威源）

## 禁止项
- 禁止执行破坏性命令（rm -rf /、DROP DATABASE）
- 禁止越权网络访问（非白名单域名）
- 禁止无测试直接合并（必须有 test pass）

## 输出格式
结论 → 已做 → 下一步

## 执行权限分层
自动可做：格式化、生成单元测试、写 README
必须人工确认：数据库改动、发布、配置变更

## 错误处理
失败时输出：最小复现步骤 + 回滚命令 + 影响面

下一步：所有工具的规则文件，只写一行：@AGENTS.md

Step 2：配置 Cursor 规则（5 分钟）

目标：让 Cursor 按规则执行。

操作流程：

• 打开 Cursor：File → Preferences → Cursor Settings
• 点击 Rules，进入规则页面
• 添加新规则，选择 Project Rules（只约束当前项目）
• 规则名称：AGENTS
• 规则内容：复制 AGENTS.md 全部内容，粘贴进去
• 保存

注意：Cursor 支持全局规则（User Rules）和项目规则（Project Rules）。建议优先用项目规则，避免污染其他项目。

Step 3：配置 Claude Code（5 分钟）

目标：Claude Code 读取 AGENTS.md。

操作流程：

• 在项目根目录创建 CLAUDE.md
• 只写一行：@AGENTS.md

@AGENTS.md

这样就够了。Claude Code 会自动读取 AGENTS.md，不用重复写规则。

Step 4：配置 OpenCode（5 分钟）

目标：OpenCode 同样引用 AGENTS.md。

操作流程：

• 在项目根目录创建 .opencode/preset.md
• 写：遵循 AGENTS.md 中的所有规则

遵循 AGENTS.md 中的所有规则

三套工具（Cursor / Claude Code / OpenCode）现在都共享同一套规则。

Step 5：设置 CI 质量闸门（20 分钟）

目标：不满足规则的代码不让过。

最小可用配置（复制即用）：

# .github/workflows/quality-gate.yml
name: Quality Gate
on: [pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: lint + typecheck
        run: npm run lint && npm run typecheck
      - name: tests
        run: npm test
      - name: spec-sync
        run: |
          # PR 必须关联 Task Contract
          gh pr view $PR --json body | grep -q "Task Contract" || exit 1

关键：lint/typecheck/test 不通过，CI 红了就不让合并。

省钱小妙招（避免上下文溢出）

• 方法 1：复杂项目分模块处理，别一个对话全改
• 方法 2：用 /summarize 压缩上下文，避免重复历史
• 方法 3：大改动先用 Plan 模式，只出计划再执行

经验：上下文太长会导致额外收费，而且质量下降。

小干货工具推荐

• mcp.so - MCP 工具仓库
• smithery.ai - MCP 工具分发平台
• https://www.skill-cn.com/ - Skills 资源站

优先用现成的 MCP/Skills，别自己写胶水代码。