SuperAPI AI 工具集

prompt-generator

编程与开发

查看项目

更新于 11-16 13:47

技能介绍

用途

Project Prompt Generator 是一个全局 Skill,用于把当前会话中已经完成、验证或纠正过的项目工作流,压缩成一个项目级、可重复执行、可维护的 Pi Prompt Template。它本身是全局的,但生成的 Prompt 永远属于当前项目,默认只创建或更新 <project-root>/.pi/prompts/prompt:<slug>.md,例如 .pi/prompts/prompt:publish-dyn.md、.pi/prompts/prompt:start-services.md,对应 /prompt:publish-dyn、/prompt:start-services 等斜杠命令。

主要能力

  • 从用户需求与会话轨迹中提取“可复用事实”,并区分已验证事实、项目稳定事实、瞬时事实和失败路径。
  • 支持将多步骤项目操作(如发包、启动服务、部署、迁移、联调、排障、回滚)提炼为单一可命名工作流。
  • 支持 Pi Prompt Template 参数语法,如 $1、$2、$@、$ARGUMENTS、${1:-default} 等,并建议只暴露真正会变化的输入。
  • 自动生成包含 frontmatter、目标与范围、执行前检查、执行流程、验证、安全与停止条件、最终报告等章节的 Prompt 骨架,按工作流裁剪。
  • 对发布/部署类工作流,强调区分构建/产物生成、注册/发布、同步/提升、部署范围、最终收敛验证。
  • 对启动服务类工作流,强调确认项目规定的启动入口、依赖服务与启动顺序、动态配置、已运行实例处理、readiness/health 验证、日志位置与失败诊断路径。
  • 写入前自检文件路径、命名、参数消费、瞬时值固化、成功验证、独立可理解性等;写入后重新读取文件并提示用户执行 /reload 后通过 /prompt:<slug> 调用。

使用方式

用户需要明确表达“把这次流程做成提示词/命令/复用流程”“根据会话生成 prompt”“沉淀刚才的发布、启动、部署、排障步骤”等意图;即使用户没有明确说 skill 也可触发。工具会先定位项目根目录(Git 仓库优先使用 git rev-parse --show-toplevel,否则使用当前工作目录),检查 .pi/prompts/ 目录,读取同名文件及 1-3 个相关 Prompt 以避免破坏现有约定。若用户未指定工作流名称,优先从最近一个已经完成或基本完成的任务轨迹中提炼。生成文件后,如果 Pi 当前会话已启动且新 Prompt 尚未出现在补全中,提示用户执行 /reload,之后可通过 /prompt:<slug> ... 调用。

适用场景

  • 用户希望将一次成功的多步骤项目操作沉淀为可重复执行的斜杠命令。
  • 用户给出新的工作流要求,并希望以后通过一个项目命令重复执行。
  • 需要将发布 Dyncode 包、启动开发服务、部署开发设备、数据库迁移等流程模板化。
  • 需要为项目内已有脚本配置生成围绕前置检查与后置验证的 Prompt,而不是重新手写底层 API 调用。

限制

  • 生成文件固定放在当前项目 .pi/prompts/prompt:<slug>.md,不是全局 Prompt。
  • 不把版本号、artifact/hash/build/deployment ID、PID、临时端口、一次性 URL、当前时间、本次查询出的设备集合等瞬时事实直接固化,应改为参数或运行时发现。
  • 不记录本次会话中的无效尝试,除非能转化为稳定的防错规则;不把模型猜测当成事实。
  • 不自动修改与本工作流无关的文件;不输出或持久化密钥、token、密码等敏感信息。
  • 发布/部署、启动服务等流程需明确成功验证条件,不能仅以命令退出码为 0 代替业务最终状态。
  • 具体安装命令、收费、价格、平台支持等事实暂未提供。