🟡 Builder 进阶 | 21 个常见任务的提示模板,可以直接复制、或者保存到 ~/.pi/agent/prompts/ 作为可复用的斜杠命令。
使用方式
这些模板可以:
- 直接复制到 Pi 输入框
- 保存为
~/.pi/agent/prompts/*.md,用 /<template-name> 调用 - 作为项目
AGENTS.md 的附件规则
不是每个任务都需要套长模板。T01 / T05 / T11 这种两三句话的 Prompt 已经覆盖了大多数"看一眼代码"的需求;T13 / T16 / T18 这类长模板才值得固化为 Skill。
代码类
T01:解释代码
1 2 3 4 5
| 解释这段代码的作用和主要逻辑:
@src/utils.ts
请用中文回答,并对关键函数加注释。
|
T02:重构代码
1 2 3 4 5 6 7 8 9
| 重构以下函数,目标: 1. 提高可读性 2. 减少嵌套 3. 添加类型安全 4. 不改变行为
@src/utils.ts
先给出修改计划,确认后再实施。
|
T03:代码审查
1 2 3 4 5 6 7 8 9
| 审查这段代码,关注: - 正确性 - 性能 - 安全性 - 可维护性
@src/auth.ts
每个问题给出:位置、原因、修复建议、风险等级。
|
T04:生成测试
1 2 3 4 5
| 为以下文件生成单元测试,使用项目现有的测试框架:
@src/calculator.ts
覆盖:正常输入、边界条件、异常输入。
|
T05:找 Bug
1 2 3
| 这个功能的异常表现是:[描述症状]
请分析 @src/feature.ts 和 @tests/feature.test.ts,找出可能的根因。不要直接修改代码。
|
文档类
T06:写 README
1
| 根据项目结构和主要代码,生成一份 README.md。包含:简介、安装、运行、测试、贡献指南。
|
T07:写 API 文档
1
| 分析 @src/routes/*.ts,生成 API 文档 Markdown。每端点包含:方法、路径、参数、响应示例、错误码。
|
T08:写发布说明
1
| 根据最近的 Git 提交(从 git log 读取),生成 Release Notes。格式:新增功能、修复、破坏性变更。
|
运维类
T09:分析日志
1 2 3 4
| 分析 @logs/app.log 的最后 200 行。找出: 1. 出现频率最高的 3 个错误 2. 可能的原因 3. 建议的排查步骤
|
T10:审查 Dockerfile
1 2 3 4 5
| 审查 @Dockerfile,检查: - 镜像体积 - 安全基线 - 缓存利用 - 多阶段构建是否必要
|
T11:CI/CD 配置审查
1 2 3 4
| 审查 @.github/workflows/ci.yml,检查: - 是否遗漏关键检查(test/lint/typecheck) - 权限是否最小化 - 缓存配置是否合理
|
研究类
T12:技术调研
1 2 3 4 5
| 我想了解 [技术名称]。请: 1. 解释核心概念 2. 列出主流方案 3. 给出选型建议 4. 列出学习资源
|
T13:竞品分析
1
| 对比 [A 方案] 和 [B 方案],维度:性能、生态、学习曲线、维护成本、适用场景。
|
T14:写学习计划
1
| 我想在 4 周内学会 [技术]。请帮我制定学习计划,每周目标 + 练习项目 + 自测标准。
|
产品类
T15:用户故事拆解
1 2 3 4 5
| 把以下需求拆解为用户故事和验收标准:
[需求描述]
输出格式:Markdown 表格,列:用户故事、验收标准、优先级、估算工时。
|
T16:PRD 生成
1
| 根据需求 [描述],生成一份简短的产品需求文档(PRD)。包含:背景、目标、范围、功能列表、非功能需求、风险。
|
安全类
T17:安全扫描
1
| 扫描项目中的常见安全风险:SQL 注入、XSS、路径遍历、硬编码密钥、不安全的反序列化。给出:位置、风险描述、修复建议。
|
T18:依赖审计
1 2 3 4
| 检查 @package.json 中的依赖: 1. 哪些已过时 2. 哪些已知安全漏洞 3. 升级建议和风险
|
效率类
T19:整理文件
1
| 把当前目录下的文件按类型整理到子目录:代码、文档、图片、数据、其他。先列出计划,确认后再移动。
|
T20:会议纪要
1 2 3 4 5
| 把以下会议记录整理成结构化纪要:
[粘贴记录]
格式:议题、决策、待办、负责人、截止时间。
|
T21:邮件起草
1
| 帮我写一封 [主题] 的邮件,语气 [正式/友好/简洁]。收件人是 [角色]。
|
封装为 Prompt Template
把模板保存为 ~/.pi/agent/prompts/refactor.md:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| --- name: refactor description: 重构代码并确认后再实施 ---
重构以下代码,目标: 1. 提高可读性 2. 减少嵌套 3. 添加类型安全 4. 不改变行为
$@
先给出修改计划,确认后再实施。
|
调用方式:
你现在应该会什么
到这里你应该能:
- 把代码、文档、运维、研究四类常见任务映射到对应模板
- 把高频模板封装到
~/.pi/agent/prompts/,用 /<name> 调用而不是每次重写 - 知道"提示模板要短"的判断——能两行写完的任务就别套五段结构
下一步