# Claude Code Prompt 模板与团队推广

> Claude Code: 从官方 Prompt library、Champion kit、Communications kit 和 What's new 提炼的可复用提示词、推广话术、试点节奏和缓存注意事项。

URL: https://docs.passion8.cc/docs/claude-code/prompt-library
Language: zh-CN
Publisher: Passion8

这页把官方 Prompt library、Champion kit、Communications kit 和 What's new 转成本地可用的中文模板。它适合两类人:个人想少写重复 prompt,团队负责人想把 Claude Code 推广成稳定习惯。




模板不是魔法。好 prompt 的核心是给 Claude 明确目标、相关上下文、允许范围、验证命令和输出格式。模板只负责让这些信息不被漏掉。




## Prompt 结构

| 部分 | 写什么 | 示例 |
| --- | --- | --- |
| 目标 | 你要完成什么,不要只写“优化一下” | 修复登录页移动端按钮重叠 |
| 上下文 | 文件、目录、日志、截图、PR、设计稿 | `@src/app/login`、失败日志、截图 |
| 边界 | 允许改哪里,不许碰哪里 | 只改 `src/app/login` 和测试 |
| 验证 | 成败证据 | `npm run lint`、390px 截图、单测 |
| 输出 | 你要计划、补丁、表格、JSON 还是 PR 描述 | 先列风险,再改文件 |

## 探索代码库

```text
只读探索这个仓库。输出:
1. 技术栈
2. 入口文件
3. 主要数据流
4. 测试和构建命令
5. 高风险区域
不要修改文件。
```

```text
解释 @src/scheduler/queue.ts 做什么,数据如何流入和流出。
按“入口、关键函数、副作用、错误处理、测试缺口”写成文档。
```

```text
哪里实现了 {行为}? 先用 rg 定位,再读相关文件。
最后列出文件路径、函数名和调用链。
```

缓存说明:探索阶段通常会读很多文件。连续追问时 5m TTL 够用;如果你会中断 10 分钟以上,1h TTL 更能保住已加载的项目前缀。

## 规划变更

```text
计划如何把 {模块} 改成 {目标}。
先列需要修改的文件、风险、兼容点和验证命令。
不要编辑任何文件。
```

```text
我要做 {功能}。请先 interview 我:
- 用户和场景
- UI / API 行为
- 权限和安全
- 空状态和错误状态
- 迁移和兼容
问完后写 SPEC.md。
```

```text
列出 {功能} 需要覆盖的 error states、empty states、loading states、权限不足和移动端边界。
不要写代码,只输出验收清单。
```

缓存说明:先规划再实现通常更缓存友好,因为模型、effort 和上下文稳定。不要在计划完成后立刻切 `/model` 或 `/effort`,否则第一轮实现会 miss。

## 实现功能

```text
参考 {已有实现} 的模式,实现 {新功能}。
范围: {允许改的目录}。
要求:
- 不引入新依赖,除非现有模式已经使用
- 保持现有 API 兼容
- 完成后运行 {验证命令}
```

```text
根据这张截图实现 UI。
完成后启动页面,截图对比原图,修掉布局、间距、颜色和文字溢出问题。
同时检查 320px、390px、1440px 和暗色主题。
```

```text
为 {模块} 增加 {测试类型}。
先找现有测试风格,再补最小覆盖。
不要为了测试改生产行为。
```

缓存说明:实现阶段最容易因为大 diff、测试输出、浏览器日志进入上下文而变贵。把失败日志裁剪到关键 100 到 200 行,比整段复制更稳。

## Debug 和修复

```text
这个测试失败了。先解释失败原因,再定位最小修复。
日志:
{粘贴关键错误}
完成后只运行相关测试,再说明是否需要全量回归。
```

```text
复现并修复这个 bug。
顺序:
1. 找最小复现或相关测试
2. 定位根因
3. 小步修改
4. 跑验证
5. 总结风险
```

```text
这段代码最近变慢了。先找性能热点和可能的重复渲染/重复请求。
不要先重构。给出证据后再改。
```

缓存说明:反复调试时尽量不要频繁 `/clear`。在同一会话里继续提供失败证据,可以让 5m/1h TTL 持续刷新。

## Review 和发布前

```text
按 code review 姿态审查当前 git diff。
只列 bug、回归风险、安全问题和缺失测试。
每条都给文件/行号、严重级别和为什么会发生。
不要做风格建议。
```

```text
生成 PR 描述:
- 背景
- 主要改动
- 验证命令和结果
- 风险
- 回滚方式
基于当前 git diff,不要编造没有运行过的测试。
```

```text
做发布前检查:
- lint/typecheck/test/build
- 关键页面手动路径
- 移动端 390px
- 浅色/暗色
- 空状态/错误状态
输出通过项、失败项和下一步。
```

缓存说明:`/diff`、review、验证日志会把很多文本带入上下文。大的 review 更适合 subagent 或 `/code-review`,主会话只接收摘要。

## 文档和知识沉淀

```text
根据当前实现更新文档。
不要猜 API 行为,从源码、测试和官方文档核对。
保留权威来源链接。
```

```text
把这次排错过程沉淀成 runbook:
- 症状
- 快速判断
- 常见原因
- 排查命令
- 修复步骤
- 回滚方式
```

```text
从最近这次任务里提炼适合写入 CLAUDE.md 的稳定规则。
只保留以后每次都需要知道的内容,不要写一次性任务记录。
```

缓存说明:文档写作常需要读大量上下文。把参考材料做成 Skill 或短 runbook,比每次粘贴长文更省缓存。

## 团队 champion 话术

个人推广 Claude Code 时,不要发抽象宣传。发一个本仓库真实例子、一个可复制 prompt、一个可验证结果。

```text
今天学到一个可复用技巧:
我让 Claude 只读 @src/components,找缺测试的组件。
Prompt:
"找出 @src/components 里没有测试或测试明显不足的组件,按风险排序。不要改文件。"
结果发现了两个我漏掉的组件。
```

```text
Plan mode 是我敢让它碰重要代码的原因。
按 Shift+Tab 切到 plan,它会先列要改哪些文件,不直接动代码。
适合第一次在陌生模块试用。
```

```text
如果你第一次用,不要拿最难的架构重构试。
找一个真实但边界清楚的任务:
- flaky test
- 补测试
- 解释陌生模块
- 修 lint
- 写 PR 描述
```

## Rollout 消息模板

```text
Claude Code 已开放给 {团队}。
它在终端/IDE 中读取当前代码库,可以解释代码、修 bug、写测试、跑验证和整理 PR。

两分钟开始:
1. 安装 Claude Code
2. 进入仓库运行 `claude`
3. 先跑 `/init`
4. 试一个真实小任务:
   "解释 @src/auth 的登录流程,列出风险,不要改文件。"

问题集中到 {支持渠道}。
数据使用、安全边界和 Provider 配置看内部说明: {链接}。
```

```text
试点要求:
本周每人至少用一次 Claude Code 做真实任务。
请在 {频道} 留三点:
- 做了什么
- 哪一步最省时间
- 哪一步不可信或卡住
这些反馈决定下一轮 rollout 策略。
```

企业推广的阶段节奏看 [企业 rollout](https://docs.passion8.cc/docs/claude-code/enterprise-rollout)。

## 按角色选择模板

| 角色 | 推荐起手 prompt |
| --- | --- |
| 新加入工程师 | “解释这个仓库的架构、入口和常用命令,不要改文件。” |
| 后端工程师 | “追踪 {API} 从路由到数据库的完整路径,列出错误处理和权限检查。” |
| 前端工程师 | “检查 {页面} 在 320/390/768/1440 下的布局、暗色主题和文字溢出。” |
| QA | “根据 {需求} 写测试清单,区分 P0/P1/P2,不要写代码。” |
| PM | “我想做 {功能},请 interview 我直到需求完整,再写 SPEC.md。” |
| 设计 | “根据截图实现原型,截图对比并修正 spacing、层级、状态和响应式。” |
| SRE | “分析这段日志,找异常模式、影响范围、可能根因和下一步命令。” |
| Tech lead | “审查当前 diff 的架构风险、兼容风险和测试缺口,只列高价值问题。” |

## 跟进官方更新

Claude Code 命令和能力变化很快。团队内部文档建议固定三个入口:

| 入口 | 用途 |
| --- | --- |
| What's new | 看最近每周新增能力,例如 `/cd`、Artifacts、MCP login、Auto mode |
| Changelog | 看具体版本修复和回归 |
| Prompt library | 给新人和团队复制起手模板 |

如果官方 What's new 出现新命令,先更新 [命令大全](https://docs.passion8.cc/docs/claude-code/commands) 和 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache),再决定是否写独立页面。

## 官方参考

- [Prompt library](https://code.claude.com/docs/en/prompt-library.md)
- [Champion kit](https://code.claude.com/docs/en/champion-kit.md)
- [Communications kit](https://code.claude.com/docs/en/communications-kit.md)
- [What's new](https://code.claude.com/docs/en/whats-new/index.md)
- [Common workflows](https://code.claude.com/docs/en/common-workflows.md)