第 0 步：起步

建仓库复制本节链接

bun create next-app my-app --yes
cd my-app
gh repo create my-app --private --source=. --push

--yes 直接用推荐的默认值：TypeScript、ESLint、Tailwind CSS、App Router，并生成一份写给 coding agent 的 AGENTS.md。create-next-app 会顺手做好第一次 git 提交，所以可以直接推到 GitHub。不想让 agent 准备匿名的 Next.js 反馈，加 --no-agent-feedback。用 shadcn/ui 的话再跑一次 bunx shadcn@latest init。

最后确认 .gitignore 里有 .env*：密钥只放 .env.local 和部署平台的环境变量里。

写一页 CLAUDE.md复制本节链接

在仓库里打开 Claude Code，运行 /init 生成初稿，再手动删到一页以内。只留每次会话都要遵守的东西：

• 技术栈和目录结构，一两行
• 常用命令：开发、测试、类型检查、lint，每条附一句“正常输出长什么样”
• 约定：命名、提交信息、文档放哪（docs/specs/、docs/plans/、docs/adr/）
• 禁区：不许碰的目录、不许跑的命令
• 指针：更长的说明放进 docs/，这里只写路径

create-next-app 生成了 AGENTS.md 的话，在 CLAUDE.md 第一行写上 @AGENTS.md。原因：仓库里两个文件都有时，Claude Code 只读 CLAUDE.md，不加这行导入，AGENTS.md 就被忽略了。下次会话运行 /context，确认 CLAUDE.md 出现在 Memory files 里。

Anthropic 的 Playbook 给了两条好用的规矩：CLAUDE.md 控制在一页以内；同一个错误 Claude 犯第二次，就往里加一条纠正。模板见一页 CLAUDE.md。

装流程引擎复制本节链接

claude plugin install mattpocock-skills@claude-plugins-official

然后在会话里跑一次 /mattpocock-skills:setup-matt-pocock-skills，每个仓库只需要一次。它会依次问三件事：

• Issue 记在哪：GitHub Issues、GitLab，或者仓库里的本地 markdown（适合一个人、没有远端的仓库）
• 分诊标签用什么：默认的五个标签直接接受即可
• 术语表和 ADR 放哪：默认仓库根目录的 GLOSSARY.md 和 docs/adr/

结果写进 docs/agents/ 下的几个说明文件，并在 CLAUDE.md 里加一节 ## Agent skills 指向它们。以后想改，直接编辑这些文件。🧪试用中

Matt 没有 hook，不会在会话开始时接管流程：16 个编排类 skill 只能手动调用，tdd、diagnosing-bugs 等 11 个纪律类 skill 模型可以自动调用。截至 2026-10，这个插件常驻上下文约 1.6k token，可以用 claude plugin details mattpocock-skills@claude-plugins-official 自己看。

配护栏复制本节链接

项目级的 .claude/settings.json 跟着仓库进 git，对这个项目里的每个会话都生效：

{
  "permissions": {
    "deny": [
      "Bash(git push --force origin main *)",
      "Bash(git reset --hard origin/main *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ],
    "ask": [
      "Bash(gh pr merge *)",
      "Bash(vercel --prod *)",
      "Bash(wrangler deploy *)",
      "Bash(bunx wrangler deploy *)"
    ],
    "allow": [
      "Bash(gh pr view *)",
      "Bash(gh run list *)",
      "Bash(vercel ls *)"
    ]
  }
}

deny 是绝对不行，ask 是每次都要你确认（合并、上线），allow 是只读命令免确认。删根目录这类对所有项目都通用的 deny 规则放用户级 ~/.claude/settings.json，见小工具的最小护栏。规则按命令文本匹配，bunx wrangler deploy 要单独写一条；更多细节见权限规则：deny、ask、allow。

想用一句话生成 hook，可以装 hookify：🧪试用中

claude plugin install hookify@claude-plugins-official

然后在会话里写 /hookify 禁止用 git add 把 .env 开头的文件加进暂存区。它会生成一个 .claude/hookify.*.local.md 规则文件，下一次工具调用就生效；规则可以设为只警告或直接阻止，/hookify:list 查看已有规则。

可选：UI 约定与自动推荐复制本节链接

• 有 UI 的项目，装 ui-contract 管“新功能放页面哪个区域”，安装和用法见设计：从 intent 到 spec。
• 新仓库可以跑一次 claude-code-setup：它只读扫描仓库，推荐值得配的 hook、skill、MCP 和 subagent。📚业界做法

claude plugin install claude-code-setup@claude-plugins-official

装好后问一句“这个仓库适合配哪些自动化”，或者直接运行 /claude-code-setup:claude-automation-recommender。用完就停用，免得它一直占上下文：claude plugin disable claude-code-setup@claude-plugins-official。