用途:当 pi:pi-companion-forwarder 需要让 Pi 处理较复杂的编码或调查任务时,使用本技能来组织提示词。Pi 运行用户所配置的模型,本插件默认面向 DeepSeek V4(审查用 Pro,日常任务用 Flash),提示词可能运行在非推理模型或推理模型上,因此应偏向具体、编号清单式的写法。
主要能力与核心规则:每次 Pi 运行只处理一个清晰任务,不相关的请求拆成多次运行;明确告诉 Pi“完成”是什么样子,不要假设它能推断出期望的终态;当无依据的猜测会降低质量时,写明显式的依据规则;使用稳定的 XML 风格标签块,使提示词具有清晰结构;保持文字简短,流程性工作优先用编号清单而非段落。
默认提示词配方:<task> 给出具体任务及相关仓库或失败上下文,包含文件路径;<output_contract>(JSON 用 <structured_output_contract>)给出确切的形状、顺序与简洁性要求;<grounding_rules> 在审查、研究或任何可能产生无依据主张的任务中必需;<action_safety> 在可写入任务中必需,指明 Pi 可触及的目录与文件类型。
额外标签块:编码或调试时加 <completeness_contract>,列出“完成”的标准(测试通过、lint 干净、涉及的文件);审查或对抗性审查直接使用已提供的 prompts/adversarial-review.md 与 prompts/review.md,不要自行另写审查提示词;研究或推荐任务加简短的 <sources> 块,列出 Pi 可查阅的范围。
提示词形态选择:审查本地 git 变更时使用内置 /pi:review 或 /pi:adversarial-review 命令,这些提示已带审查契约;诊断、规划、研究或实现且需要更直接控制提示词时使用 task;对同一 Pi 会话追加指示使用 task --resume-last,只发送增量指令而非重述整个提示词,除非方向发生实质变化。
工作规则:优先显式提示词契约而非含糊提示;不要默认提高推理(--effort high),DeepSeek Flash 不会受益、DeepSeek Pro 会更慢,应先收紧提示词再考虑升级 effort;对工具密集或长时间任务,让 Pi 在工作笔记中给出简短的、基于结果的进度更新;主张须锚定可观察证据,假设需明确标注。
组装清单:在 <task> 中定义确切任务与范围;说明输出契约(JSON、项目符号列表或纯文本)及最大长度;决定 Pi 应自行判断继续还是因缺少高风险细节而停下;仅在需要处添加 <grounding_rules> 与 <action_safety>;发送前删除冗余指令。
子代理感知提示:安装 pi-subagents 后,对含并行工作流的任务,在 <task> 之前加 <available_pi_subagents> 块。建议路由:scout 用于探索,researcher 用于网络/文档,planner 用于设计,worker 用于实现,reviewer 用于代码审查。切勿在对抗性审查或 stop-review-gate 提示词中建议子代理,这些需要确定性行为。该块是建议而非命令,Pi 自行决定是否委派。需要专门的多任务并行执行时,使用 /pi:parallel-rescue "task1" "task2" ... 而非手工构造提示词。
限制:资料未提供价格、平台支持范围、模型版本细节或效果保证等事实。