SuperAPI AI 工具集

skill-to-prompt

营销与增长

查看项目

更新于 10-16 02:09

技能介绍

用途

Skill to Prompt Converter 用于将 Claude 技能(SKILL.md 加 references/ 目录)转换为 ChatGPT Project 格式。转换结果为两份 .docx 文档:一份提示指令文档,用于粘贴到 ChatGPT 的「Instructions」字段,字符数需低于 8,000;一份知识文件文档,作为参考资料上传到 ChatGPT Project。

主要能力

每次转换产出:

  • 提示指令(.docx):粘贴到 ChatGPT「Instructions」字段的文本,低于 8,000 字符,按 9 组件提示公式组织。
  • 知识文件(1 个 .docx):上传到 ChatGPT Project 作为参考资料,包含所有详细工作流、模板、框架、示例和参考内容,整合为单一文档。

所有 .docx 文件遵循统一格式:Arial 字体、正文 10pt、H1 为 20pt、H2 为 16pt、H3 为 14pt、H4 为 12pt、1.15 倍行距。

使用方式

转换工作流包含以下步骤:

  1. 定位并读取源技能。若用户提供技能名(如 copywriting),在 ~/.claude/skills/[skill-name]/SKILL.md 查找;若提供路径则直接使用。读取 SKILL.md 全文、references/ 目录下所有文件,并记录 scripts/ 或 assets/ 文件夹。
  2. 分析技能复杂度。按 SKILL.md 行数与参考文件数量分为简单(少于 300 行、无参考文件)、中等(300 至 500 行或 1 至 2 个参考文件)、复杂(500 行以上或 3 个以上参考文件)三档,决定压缩程度。无论复杂度如何,始终只产出 1 个知识文件。
  3. 将内容映射到 9 组件提示公式,参考 references/prompt-structure-guide.md。映射关系包括:frontmatter description 对应角色与任务摘要;「When to Use」对应任务上下文;「Before Starting」对应输入与变量;核心工作流对应任务(精简步骤);「Output Format」对应格式说明;「Examples」对应示例输出(指令中最多 1 至 2 个);「Constraints」对应约束;目标受众对应受众;语气指导对应风格与语气;目的描述对应目标。
  4. 在指令与知识文件之间拆分内容,按优先级控制字符数。P1 始终放入指令:角色声明、任务概述、目标、关键约束、知识文件引用。P2 在字符预算允许时放入指令:1 至 2 个关键示例、输入变量、输出格式规范、风格与语气指导。P3 始终放入知识文件:完整详细工作流、完整示例库、模板与框架、全部参考资料、边界情况与高级场景、决策树与详细表格、脚本代码(作为参考记录)。指令文本目标为 7,500 字符,保留 500 字符安全余量。
  5. 撰写提示指令。每份指令文档必须按固定顺序包含全部 9 个标题,不得省略或改名:Role、Task、Goal、Audience、Style/Tone、Constraints、Inputs/Placeholders、Example Output、Formatting Instructions。之后追加 Knowledge Files 部分。风格部分始终包含写作规则:避免破折号,优先使用逗号、句号或连词;仅在不可避免时使用带空格的短破折号或不带空格的长破折号,且每篇完整输出中最好不超过一次。草稿完成后统计字符数,超过 7,500 则精简示例、压缩工作流步骤、缩短受众与风格内容(但标题不得删除);超过 8,000 则进一步缩短各节内容,9 个标题仍须保留,详细说明移入知识文件。
  6. 组织知识文件内容。始终产出 1 个名为 [SkillName]_Reference_Guide.docx 的知识文件,整合全部 P3 内容,使用清晰标题层级:H1 用于主要部分(工作流、模板、示例、参考资料),H2 至 H3 用于子部分,主要部分之间使用分页符。
  7. 生成 JSON 数据,结构匹配 docx-generator 输入格式,包含 skillName、originalSkillName、version、outputDir、instructionDoc(filename、title、characterCount、sections)与 knowledgeFiles 数组。将 JSON 写入当前目录的临时文件 [skill-name]-conversion.json。
  8. 生成 .docx 文件,运行命令:NODE_PATH=~/Documents/node_modules node ~/.claude/skills/skill-to-prompt/references/docx-generator.js [skill-name]-conversion.json,输出到 ~/Downloads/。若 docx 包不可用,先执行 cd ~/Documents && npm install docx && cd -。若 .docx 生成完全失败,则输出格式化 markdown 供用户粘贴到 Google Docs 或 Word。
  9. 校验并呈现结果:检查指令字符数(须低于 8,000)、所有 .docx 是否成功生成、知识文件是否包含完整引用内容、指令与知识文件之间的交叉引用是否清晰。向用户呈现转换结果与 ChatGPT 配置步骤:在 ChatGPT 新建 Project、将指令文本粘贴到 Instructions 字段、上传知识文件、用示例提示测试。之后清理临时 JSON 文件。

转换规则

可直接迁移的内容:角色与目的定义、工作流步骤(精简后)、约束与规则、输出格式规范、示例与模板、参考内容。

需要改写的内容:Claude 工具引用(Read、Grep、Glob、Bash、Edit、Write)改写为自然语言指令,例如「Read the user's file」改为「Ask the user to paste or upload the content」;动态命令(!command 语法)在 ChatGPT 中不可用,记录为手动步骤;文件系统操作替换为「请用户提供」模式;渐进式披露(按需加载参考)改为所有内容预先放入知识文件。

无法迁移的内容:脚本(scripts/ 文件夹)在知识文件中记录用途,可附代码作为参考但注明无法在 ChatGPT 中执行;资产(assets/ 文件夹)注明「如需使用必须手动转移」;跨技能引用标记为依赖并建议单独转换;MCP 服务器集成在 ChatGPT Projects 中不可用;frontmatter 字段(version、argument-hint、context、agent、allowed-tools)为 Claude 专有元数据,不写入 ChatGPT 指令。

输出命名与格式标准

命名约定为 [SkillName]_Prompt_Instructions.docx 与 [SkillName]_Reference_Guide.docx,其中 [SkillName] 为技能名的标题式写法,空格替换为下划线。例如 copywriting 对应 Copywriting_Prompt_Instructions.docx,digital-product-video-ads 对应 Digital_Product_Video_Ads_Prompt_Instructions.docx,page-cro 对应 Page_CRO_Prompt_Instructions.docx。

文档格式标准:Arial 字体;所有文本与标题为默认黑色;正文 10pt;H1 为 20pt;H2 为 16pt;H3 为 14pt;H4 为 12pt;1.15 倍行距。标题仅通过字号区分样式,不加额外加粗;所有文本与标题必须为默认黑色,不得使用其他颜色;每段后添加间距;表格使用交替行底纹。生成 .docx 时须在每个元素上显式设置 Arial 字体、标题字号、黑色(不使用主题色)与 1.15 倍行距,不得依赖 Word 默认样式。

适用场景

适用于需要把已有 Claude 技能迁移到 ChatGPT Project 的用户,尤其是希望保留技能中的工作流、模板、框架与示例,同时适配 ChatGPT 的指令字段字符限制与知识文件上传机制的场景。

限制

指令文本必须低于 8,000 字符;始终只产出 1 个知识文件;脚本、资产、MCP 集成与 Claude 专有 frontmatter 无法直接迁移;动态命令与文件系统操作需改写为手动步骤。相关技能包括 agent-skill-builder(反向转换,将 ChatGPT Projects 转为 Claude 技能)与 skill-creator(从零创建 Claude 技能的指南)。