Prompt 模板与团队推广
从官方 Prompt library、Champion kit、Communications kit 和 What's new 提炼的可复用提示词、推广话术、试点节奏和缓存注意事项。
这页把官方 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 描述 | 先列风险,再改文件 |
#探索代码库
只读探索这个仓库。输出:
1. 技术栈
2. 入口文件
3. 主要数据流
4. 测试和构建命令
5. 高风险区域
不要修改文件。解释 @src/scheduler/queue.ts 做什么,数据如何流入和流出。
按“入口、关键函数、副作用、错误处理、测试缺口”写成文档。哪里实现了 {行为}? 先用 rg 定位,再读相关文件。
最后列出文件路径、函数名和调用链。缓存说明:探索阶段通常会读很多文件。连续追问时 5m TTL 够用;如果你会中断 10 分钟以上,1h TTL 更能保住已加载的项目前缀。
#规划变更
计划如何把 {模块} 改成 {目标}。
先列需要修改的文件、风险、兼容点和验证命令。
不要编辑任何文件。我要做 {功能}。请先 interview 我:
- 用户和场景
- UI / API 行为
- 权限和安全
- 空状态和错误状态
- 迁移和兼容
问完后写 SPEC.md。列出 {功能} 需要覆盖的 error states、empty states、loading states、权限不足和移动端边界。
不要写代码,只输出验收清单。缓存说明:先规划再实现通常更缓存友好,因为模型、effort 和上下文稳定。不要在计划完成后立刻切 /model 或 /effort,否则第一轮实现会 miss。
#实现功能
参考 {已有实现} 的模式,实现 {新功能}。
范围: {允许改的目录}。
要求:
- 不引入新依赖,除非现有模式已经使用
- 保持现有 API 兼容
- 完成后运行 {验证命令}根据这张截图实现 UI。
完成后启动页面,截图对比原图,修掉布局、间距、颜色和文字溢出问题。
同时检查 320px、390px、1440px 和暗色主题。为 {模块} 增加 {测试类型}。
先找现有测试风格,再补最小覆盖。
不要为了测试改生产行为。缓存说明:实现阶段最容易因为大 diff、测试输出、浏览器日志进入上下文而变贵。把失败日志裁剪到关键 100 到 200 行,比整段复制更稳。
#Debug 和修复
这个测试失败了。先解释失败原因,再定位最小修复。
日志:
{粘贴关键错误}
完成后只运行相关测试,再说明是否需要全量回归。复现并修复这个 bug。
顺序:
1. 找最小复现或相关测试
2. 定位根因
3. 小步修改
4. 跑验证
5. 总结风险这段代码最近变慢了。先找性能热点和可能的重复渲染/重复请求。
不要先重构。给出证据后再改。缓存说明:反复调试时尽量不要频繁 /clear。在同一会话里继续提供失败证据,可以让 5m/1h TTL 持续刷新。
#Review 和发布前
按 code review 姿态审查当前 git diff。
只列 bug、回归风险、安全问题和缺失测试。
每条都给文件/行号、严重级别和为什么会发生。
不要做风格建议。生成 PR 描述:
- 背景
- 主要改动
- 验证命令和结果
- 风险
- 回滚方式
基于当前 git diff,不要编造没有运行过的测试。做发布前检查:
- lint/typecheck/test/build
- 关键页面手动路径
- 移动端 390px
- 浅色/暗色
- 空状态/错误状态
输出通过项、失败项和下一步。缓存说明:/diff、review、验证日志会把很多文本带入上下文。大的 review 更适合 subagent 或 /code-review,主会话只接收摘要。
#文档和知识沉淀
根据当前实现更新文档。
不要猜 API 行为,从源码、测试和官方文档核对。
保留权威来源链接。把这次排错过程沉淀成 runbook:
- 症状
- 快速判断
- 常见原因
- 排查命令
- 修复步骤
- 回滚方式从最近这次任务里提炼适合写入 CLAUDE.md 的稳定规则。
只保留以后每次都需要知道的内容,不要写一次性任务记录。缓存说明:文档写作常需要读大量上下文。把参考材料做成 Skill 或短 runbook,比每次粘贴长文更省缓存。
#团队 champion 话术
个人推广 Claude Code 时,不要发抽象宣传。发一个本仓库真实例子、一个可复制 prompt、一个可验证结果。
今天学到一个可复用技巧:
我让 Claude 只读 @src/components,找缺测试的组件。
Prompt:
"找出 @src/components 里没有测试或测试明显不足的组件,按风险排序。不要改文件。"
结果发现了两个我漏掉的组件。Plan mode 是我敢让它碰重要代码的原因。
按 Shift+Tab 切到 plan,它会先列要改哪些文件,不直接动代码。
适合第一次在陌生模块试用。如果你第一次用,不要拿最难的架构重构试。
找一个真实但边界清楚的任务:
- flaky test
- 补测试
- 解释陌生模块
- 修 lint
- 写 PR 描述#Rollout 消息模板
Claude Code 已开放给 {团队}。
它在终端/IDE 中读取当前代码库,可以解释代码、修 bug、写测试、跑验证和整理 PR。
两分钟开始:
1. 安装 Claude Code
2. 进入仓库运行 `claude`
3. 先跑 `/init`
4. 试一个真实小任务:
"解释 @src/auth 的登录流程,列出风险,不要改文件。"
问题集中到 {支持渠道}。
数据使用、安全边界和 Provider 配置看内部说明: {链接}。试点要求:
本周每人至少用一次 Claude Code 做真实任务。
请在 {频道} 留三点:
- 做了什么
- 哪一步最省时间
- 哪一步不可信或卡住
这些反馈决定下一轮 rollout 策略。企业推广的阶段节奏看 企业 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 出现新命令,先更新 命令大全 和 命令与缓存影响,再决定是否写独立页面。
#官方参考
Support / 支持
Need help? / 需要帮助?
接入、计费与模型异常可邮件联系;服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right

