🟡 Builder 进阶 | 45 条按场景分类的 Pi 命令片段。多数是 pi -p "..." 或 pi --tools read,grep,find,ls -p "..." 的一行调用——把它们存成 shell alias、prompt template 或者写进 AGENTS.md 都行。

代码类

R01:解释陌生代码库

1
pi --tools read,grep,find,ls -p "分析这个项目:技术栈、目录结构、核心模块、启动入口"

R02:快速定位 Bug

1
pi --tools read,grep,find,ls -p "用户报告:登录后跳转 404。找出可能的原因,列出文件和行号。"

R03:重构一个函数

1
pi -p "重构 @src/utils.ts 中的 calculateTotal(),要求:可读性、类型安全、减少嵌套、行为不变。先给计划。"

R04:补全单元测试

1
pi -p "为 @src/services/userService.ts 生成单元测试,用现有 Jest 框架,覆盖正常/边界/异常。运行 npm test 验证。"

R05:生成 API 文档

1
pi -p "分析 @src/routes/*.ts,生成 API 文档 Markdown。包含:方法、路径、参数、响应示例、错误码。"

R06:升级依赖

1
pi --tools read -p "分析 @package.json,列出过时依赖、最新版本、是否有破坏性变更。不要直接升级。"

R07:安全扫描

1
pi --tools read,grep,find,ls -p "扫描项目中的安全风险:注入、XSS、路径遍历、硬编码密钥、不安全反序列化。给出位置、等级、修复建议。"

R08:性能分析

1
pi --tools read -p "分析 @src/main.ts,找出可能的性能瓶颈:循环、内存泄漏、不必要的拷贝。"

R09:代码风格统一

1
pi -p "检查 @src/**/*.ts 是否符合项目代码风格。列出不符合的文件和原因。不要直接修改。"

R10:生成 Commit Message

1
git diff --cached | pi -p "根据以上 diff 生成符合 Conventional Commits 的提交信息"

文档类

R11:写 README

1
pi -p "根据项目结构和代码,生成 README.md。包含:简介、安装、运行、测试、贡献指南。"

R12:写 CHANGELOG

1
git log --oneline -n 20 | pi -p "根据以上提交生成 CHANGELOG 条目"

R13:写技术方案

1
pi -p "我要实现 [功能]。请给出:技术选型、方案对比、推荐方案、风险点。"

R14:写会议纪要

1
pi -p "把以下会议记录整理成结构化纪要:[粘贴]"

R15:写邮件

1
pi -p "帮我写一封 [主题] 的邮件,语气 [正式/友好],收件人 [角色]"

运维类

R16:分析日志

1
tail -n 500 logs/app.log | pi -p "找出最常见的 3 个错误和可能原因"

R17:Dockerfile 审查

1
pi -p "审查 @Dockerfile:镜像体积、安全基线、缓存利用、多阶段构建是否必要"

R18:CI 配置审查

1
pi -p "审查 @.github/workflows/ci.yml:是否遗漏检查、权限是否最小化、缓存是否合理"

R19:数据库迁移审查

1
pi -p "审查 @migrations/20260810_add_users.sql:数据丢失风险、索引、向后兼容"

R20:生产事故排查

1
pi --tools read,grep,find,ls -p "生产 500 错误,路径 /api/checkout。分析代码和日志,找出根因。不要修改代码。"

产品类

R21:需求拆解

1
pi -p "把以下需求拆解为用户故事和验收标准:[需求]。输出 Markdown 表格。"

R22:PRD 生成

1
pi -p "根据需求 [描述],生成简短 PRD:背景、目标、范围、功能列表、非功能需求、风险。"

R23:竞品分析

1
pi -p "对比 [A] 和 [B]:性能、生态、学习曲线、维护成本、适用场景"

效率类

R24:整理文件

1
pi --tools read,find,ls -p "把当前目录文件按类型整理到子目录:代码、文档、图片、数据、其他。先给计划。"

R25:重命名批量文件

1
pi --tools read,find,ls -p "把 *.jpeg 重命名为 .jpg。先列出计划。"

R26:生成目录结构

1
pi --tools read,find,ls -p "生成项目目录结构树,标注每个目录用途"

R27:统计代码

1
pi --tools read,find,ls -p "统计项目代码行数,按语言分类"

学习类

R28:技术调研

1
pi -p "我想了解 [技术]。请:解释核心概念、列出主流方案、给出选型建议、列出学习资源。"

R29:学习计划

1
pi -p "我想在 4 周内学会 [技术]。制定计划:每周目标、练习项目、自测标准。"

R30:代码教学

1
pi -p "用中文解释 @src/algorithm.ts 的核心算法,像老师教学生一样。"

安全类

R31:依赖审计

1
pi --tools read -p "分析 @package.json 的依赖:哪些过时、哪些有已知漏洞、升级建议"

R32:密钥扫描

1
pi --tools read,grep,find,ls -p "扫描项目中可能的硬编码密钥、token、密码"

R33:权限审查

1
pi --tools read -p "审查 @src/auth.ts 的权限逻辑,找出越权风险"

数据类

R34:CSV 分析

1
pi --tools read -p "分析 @data/sales.csv,给出统计摘要和趋势"

R35:JSON 转换

1
pi --tools read -p "把 @data/config.json 转换成 YAML 格式"

R36:日志转结构化

1
pi --tools read -p "把 @logs/app.log 解析成结构化 JSON"

多步骤类

R37:新功能开发

1
pi -p "实现用户个人资料页面:显示信息、头像上传、活动历史。遵循现有代码风格。先给计划,再实施。"

R38:迁移到 TypeScript

1
pi --tools read,grep,find,ls -p "分析 src/ 下的 .js 文件,制定迁移到 TypeScript 的计划。"

R39:项目脚手架

1
pi -p "为一个 Node.js + Express + TypeScript 项目生成脚手架目录结构和基础配置"

R40:文档站生成

1
pi -p "根据项目代码和注释,生成一个 Markdown 文档站结构"

调试类

R41:类型错误修复

1
npm run typecheck 2>&1 | pi -p "修复这些 TypeScript 错误"

R42:测试失败修复

1
npm test 2>&1 | pi -p "分析测试失败原因并修复"

R43:Lint 修复

1
npm run lint 2>&1 | pi -p "修复所有 lint 错误"

协作类

R44:代码审查回复

1
pi -p "根据以下审查意见,给出修改方案:[粘贴意见]"

R45:PR 描述生成

1
git diff main...HEAD | pi -p "根据以上 diff 生成 PR 描述"

你现在应该会什么

到这里你应该能:

  • 在"代码 / 文档 / 运维 / 产品 / 效率 / 学习 / 安全 / 数据 / 多步骤 / 调试 / 协作"十一个场景里挑出对应的 pi -p / pi --tools ... 一行调用
  • 把自己常用的 5–8 条封装成 shell alias 或 Prompt Template
  • 知道哪些场景属于"先用 L0 只读分析、再放开 bash"的节奏(基本所有 R* 调试类)

下一步

站内搜索

没有找到内容!