常用提示词库¶
按场景分类的可复用提示词模板，直接复制使用，按需填写 [占位符]。
功能开发类¶
新增 API 接口¶
背景：[项目名] 使用 [框架]，接口统一返回 { data, error, code } 格式。
相关文件：[附上现有接口文件]
目标：实现 [HTTP 方法] [路径] 接口。
输入参数：[参数列表和类型]
返回格式：[成功响应] / [错误响应]
范围：只修改 [文件路径]
不改动：[禁止修改的文件或目录]
约束：
- 参数验证使用 [验证库]
- 错误处理沿用现有中间件
- 不引入新依赖
验收：[测试命令] 通过
新增前端组件¶
背景：项目使用 [框架] + [样式方案]，组件库为 [组件库名]。
参考组件：[附上同类组件代码]
目标：创建 [组件名] 组件。
Props：[Props 类型定义]
行为：[交互描述]
样式：[样式要求]
范围：创建 src/components/[组件名].tsx，不修改其他文件
约束：不引入新的 npm 包，沿用现有设计 token
验收：组件在 [页面] 中正常渲染，无 TypeScript 错误
数据库迁移¶
背景：项目使用 [ORM]，数据库为 [数据库类型]。
现有 Schema：[附上相关 Schema 文件]
目标：[迁移描述，如"为 users 表添加 avatar_url 字段"]
字段定义：[字段名、类型、约束、默认值]
范围：只创建迁移文件，不修改现有 Schema 文件
约束：迁移必须可回滚
验收：[迁移命令] 执行成功，[回滚命令] 执行成功
重构类¶
函数重构¶
背景：以下函数需要重构，接口保持不变。
现有实现：[附上函数代码]
现有测试：[附上测试代码]
目标：[重构目标，如"提取重复逻辑"、"降低圈复杂度"]
约束：
- 函数签名不变
- 所有现有测试必须继续通过
- 不改动调用方
验收：[测试命令] 通过，[类型检查命令] 无错误
依赖升级¶
背景：项目当前使用 [依赖名] v[旧版本]，需要升级到 v[新版本]。
变更日志关键点：[附上 breaking changes]
目标：完成升级并修复所有 breaking changes。
范围：只修改受影响的文件，不做额外重构
验收：[构建命令] 成功，[测试命令] 通过
调试类¶
Bug 修复¶
背景：[项目名]，相关模块：[模块路径]
问题描述：[具体现象]
复现步骤：
1. [步骤 1]
2. [步骤 2]
期望行为：[期望]
实际行为：[实际]
错误信息：
[完整错误堆栈]
相关代码：[附上相关文件]
约束：
- 只修改导致 Bug 的根因，不做额外改动
- 修复后添加防回归测试
验收：复现步骤不再触发错误，新增测试通过
性能问题排查¶
背景：[接口/页面] 响应时间过长，当前 P99 为 [时间]，目标 [时间]。
性能数据：[附上 profiling 结果或慢查询日志]
相关代码：[附上相关文件]
目标：定位性能瓶颈并提出优化方案（先不实现，等确认后再改）
约束：不改变接口行为，不引入新依赖
输出格式：
1. 瓶颈定位（2-3 个候选原因）
2. 推荐优化方案
3. 预期效果
文档类¶
生成 API 文档¶
以下是 [接口名] 的实现代码，请生成 OpenAPI 3.0 格式的接口文档。
代码：[附上接口代码]
要求：
- 包含所有参数的类型和描述
- 包含成功和错误响应示例
- 使用中文描述
- 输出 YAML 格式
生成测试用例¶
以下是 [函数/接口] 的实现，请生成完整的测试用例。
实现代码：[附上代码]
测试框架：[框架名]
要求：
- 覆盖 Happy Path
- 覆盖所有错误分支
- 覆盖边界情况（空值、最大值、并发等）
- 每个测试用例有清晰的描述
代码审查类¶
PR 代码审查¶
请审查以下代码改动，重点关注正确性问题（不是风格问题）。
改动内容：[附上 diff 或改动文件]
背景：[这个 PR 要解决什么问题]
测试覆盖：[已有哪些测试]
审查重点：
1. 逻辑错误或边界情况遗漏
2. 安全隐患（注入、越权、敏感数据泄露）
3. 并发或竞态条件
4. 性能问题（N+1 查询、不必要的循环）
输出格式：
- 按严重程度分级（阻塞/建议/可选）
- 每条问题说明位置、原因和修复建议
- 不超过 10 条，只列真正重要的
安全审查¶
请对以下代码进行安全审查，重点检查 OWASP Top 10 相关风险。
代码：[附上相关文件]
功能描述：[这段代码做什么]
数据敏感性：[处理哪类数据，如用户密码、支付信息]
检查项：
- SQL 注入 / NoSQL 注入
- XSS（跨站脚本）
- 身份验证和授权缺陷
- 敏感数据暴露（日志、响应体）
- 输入验证缺失
输出格式：
- 发现的风险（高/中/低）
- 具体位置和触发条件
- 修复建议（附代码示例）
架构评审¶
请评审以下设计方案，从可维护性和扩展性角度给出意见。
方案描述：[设计文档或伪代码]
当前规模：[用户量、数据量、团队规模]
未来 6 个月预期变化：[可能的需求变化]
评审维度：
1. 模块边界是否清晰
2. 是否存在过度设计或设计不足
3. 数据流是否合理
4. 潜在的扩展瓶颈
输出：优点 2-3 条，风险 2-3 条，改进建议 1-2 条
上下文注入类¶
项目约定注入¶
在每次新对话开始时使用，让 AI 快速了解项目背景：
【项目背景】
项目：[项目名和简介]
技术栈：[框架、语言、主要依赖]
代码规范：[命名约定、文件结构]
测试框架：[测试工具和运行命令]
【禁止事项】
- 不引入 [某类依赖]
- 不修改 [某个目录或文件]
- 不改变 [某个接口的签名]
【当前任务】
[任务描述]
错误上下文注入¶
遇到报错时，提供完整上下文让 AI 精准定位：