用途:根据一段简短的用户需求,快速创建轻量、可直接使用的 Pi 资源,即提示模板(prompt template)或 Agent 技能(skill),并遵循 Agent Skills 约定与渐进式披露原则,仅在上下文中保留最小元数据,较大参考资料单独存放。
主要能力:校验需求描述,若缺少关键信息只提一个简洁的澄清问题;当 kind 为 auto 时自动推断适合提示模板还是技能;生成安全 slug(小写字母、数字、连字符,1–64 字符,无首尾或连续连字符,SKILL.md 需与父目录同名);按 Pi 约定写入文件:提示模板位于 ~/.pi/agent/prompts/<name>.md,技能位于 ~/.pi/agent/skills/<name>/SKILL.md。技能文件包含 YAML frontmatter(name 与 description 作为触发字段)以及 Purpose、Setup、Workflow、Examples 等简短正文;提示模板包含 frontmatter description、简短可复用提示正文与使用说明。
使用方式:输入 JSON 载荷或等价用户消息,字段包括 kind(auto/prompt/skill)、scope(global/project,global 优先)、brief(一段描述)、可选 name(slug 提示)。示例命令:/skill:creatorskill {"kind":"skill","scope":"global","brief":"Create a skill that reviews staged git changes for security issues and outputs a short remediation plan."};提示模板示例:/skill:creatorskill {"kind":"prompt","scope":"global","brief":"Template for reviewing staged git changes with a strict security checklist."}。
适用场景:需要从简短描述快速搭建新提示模板或技能骨架;需要为 Pi 或其他 Agent Skill 运行时编写小型、符合规范的 SKILL.md;希望变更先在对话中暂存、便于人工审阅。
限制:该技能只准备并写入所选 scope 下的文件,不运行、不安装任何内容,也不执行外部命令或生成的脚本;创建成功后仅汇总写入的文件及其绝对路径,供用户自行审阅和手动运行。frontmatter 必须包含 name 与 description,description 应包含触发上下文;正文保持简洁,大型示例或参考资料应放入 references/ 目录并从 SKILL.md 链接。