Skill 安装使用教程

编辑：MirrorWorkforce
API渠道问题以及订单问题联系店长，微信：Slow_Life10086，QQ：1257289366
配置相关等问题联系管理员，微信：__Lucky-Forever__，QQ：1871867945

1.Codex PPT Skill

一个面向 Codex 的 PPT 生成 skill，也可在 Claude Code、OpenClaw、Hermes Agent 等支持 SKILL.md 的 agent 中使用；在这些非 Codex 环境中通常需要配置 gpt-image-2 或第三方 OpenAI 兼容格式的生图 API。

它把文章、报告、论文、课程笔记等内容转换成“整页图片式”的演示文稿：先规划大纲和视觉风格，再生成每页幻灯片图片，最后用本地脚本组装为 .pptx。

1.1 GitHub作者温馨提示

这个 skill 主要给大家提供一个还不错的 PPT 生成流程。为了尽量通用，它的流程设计会稍微复杂一些；复杂也会带来不稳定性或者冗余性。比如它同时兼容Codex内置生图和 API/CLI fallback 生图，也会兼容有无子agent可用这种情况，但大部分人日常使用时其实只会固定走其中一条路线。

💡 强烈建议：先跑通，再固化成自己的专属版本

建议大家在走通自己常用的路线之后，让 AI 帮你改一下这个 skill，把你的偏好固定下来，省得每次都重新选择。比如固定使用内置生图或固定使用某个 API，固定是否使用子 agent，固定常用输出目录、风格、页数节奏等。

🎨 建立自己的 PPT 风格库

另外，如果你在做 PPT 的过程中遇到了自己喜欢的版式或排版，无论是这个 skill 做出来的，还是从别的地方找到的 PPT 风格图片，都可以让 AI 加到这个 skill 的 references 里，逐步形成你自己的风格库。Skills 本质上是非常个性化的流程，鼓励大家在使用这个 skill 的基础上，按自己的偏好持续调优，让它更适配自己的工作流。

关于 skills 如何设计和使用，可以参考 good-skill-design.pptx 。这个 PPT 也是用本 skill 做的，采用的是手绘技术解释风；内容基于 Claude 在设计 skills 方面的最佳实践文章 The Complete Guide to Building Skills for Claude。祝大家玩得愉快！

1.2 特点

在 Codex 中优先使用内置生图和编辑能力；在其他 agent 中可使用本地 API/CLI fallback
同时支持 Codex、Claude Code、OpenClaw、Hermes Agent 等多种 agent 环境
支持使用第三方 OpenAI 兼容接口提供的 gpt-image-2 生图模型
图片式 PPT：每页幻灯片是一张完整 16:9 图片，适合强视觉表达
支持为某一页指定必须插入的图片素材，例如论文原图、实验结果图、截图或架构图
风格参考库：内置清爽专业、科研答辩、电子墨水杂志、手绘技术解释、仪表盘等多种风格说明
整套 PPT 保持统一视觉语言，但每页会按内容语义调整版式，避免机械重复
本地组装脚本：将 slide_01.png、slide_02.png 等图片打包成 PowerPoint

1.3 生成效果

1.4 风格示例

清爽专业风	创意杂志风
电子墨水杂志风	数据仪表盘风
复古扁平插画风	手绘技术解释风
手绘白板风	温暖手工风
科研答辩风

1.5 输出结构

每个 PPT 会生成一个独立项目目录：

text

{基础目录}/{PPT名称}/
├── origin_image/
│   ├── slide_01.png
│   ├── slide_02.png
│   └── ...
├── outline.md
├── speech.md
└── {PPT名称}.pptx

origin_image/ 只放正式页图片，并按slide_01.png、slide_02.png这样的顺序命名。样张确认也直接使用对应页的正式文件名；如果要保留废稿或对比图，放到项目根目录或单独的 drafts/ 目录，不要放进 origin_image/。

speech.md会在组装时写入 PPT 的每页备注。建议使用 ## Slide 1: 标题、## Slide 2: 标题这样的标题格式，脚本会按页码匹配。

1.6 适用场景

技术文章转分享 PPT
论文或报告转演示稿
课程笔记转课件
科研项目申报、中期检查、结题验收和论文答辩
商业汇报、产品介绍、调研总结
需要强视觉统一性的图片式演示文稿

1.7 安装

推荐使用 skills CLI 安装到 Codex 的全局 skills 目录：

bash

npx -y skills@latest add ningzimu/codex-ppt-skill \
  --skill codex-ppt \
  --agent codex \
  --global

安装完成后，重启 Codex 让新 skill 生效。

也可以直接下载 codex-ppt-skill-v*.zip ，解压后把其中的 codex-ppt 文件夹放到 ~/.codex/skills/codex-ppt，然后重启 Codex。

1.8 生图模型配置

只有在需要通过 API/CLI fallback 生图时，才需要配置生图模型。指定图片分辨率、提高质量或要求修改某一页，本身不会触发第三方 API 配置；如果 Codex 内置图片生成工具可用，会继续使用内置工具。典型需要配置的情况包括：

在 Codex 中使用第三方 API 或兼容中转站接入时，通常无法使用内置的图片生成工具。
在 Claude Code、OpenClaw、Hermes Agent 等环境中使用该 skill。

如果你是通过 GPT 会员订阅使用 Codex，并且 Codex 内置图片生成工具可用，则不需要配置 gpt-image-2 生图模型；这种情况下 Codex 已经内置了该图片生成能力。即使你在提示里明确说“使用 gpt-image-2”，也应优先理解为使用 Codex 内置图片生成工具，而不是切换到本地 API/CLI fallback。

只有在已经明确选择 API/CLI fallback 时，agent 才应该检查 ~/.codex-ppt-skill/.env 并在缺少配置时报 OPENAI_API_KEY。不要在 Codex 内置图片生成工具可用时，因为用户提到 gpt-image-2 就要求配置 API key。base URL 只有使用第三方中转站时才需要配置，模型名缺省为 gpt-image-2，只有中转站要求自定义模型名时才需要修改。配置完成后 Codex、Claude Code、OpenClaw、Hermes Agent 会复用同一套配置。

手动排查时也可以直接运行配置命令：

bash

python3 /path/to/codex-ppt-skill/skills/codex-ppt/scripts/codex_ppt_runtime.py config \
  --api-key "your-api-key" \
  --base-url "https://api.mirrorworkforce.cn/v1" \
  --model openai/gpt-image-2

其中--api-key是你的API key；--model是图片模型名，默认可使用gpt-image-2。配置会写入~/.codex-ppt-skill/.env。不要把API key写进项目目录或提交到仓库。

1.9 使用方式

在 Codex、Claude Code、OpenClaw 或 Hermes Agent 中明确指定使用 codex-ppt skill，例如：

text

请使用 codex-ppt skill 把 /path/to/article.md 做成 10 页左右的 PPT。

skill 会按以下流程执行：

阅读内容并规划 PPT 大纲
生成 outline.md，并请求你确认页数、标题和每页要点
给出 2-3 个视觉风格选项，并推荐一个让用户确认
在首次生图前说明将使用的生图方式，并请求你确认
使用确认后的图片生成后端先生成 1 页样张，让用户确认风格、版式节奏和文字质量
创建 PPT 项目目录
使用同一图片生成后端逐页生成全部幻灯片图片
检查文字清晰度、风格一致性和内容完整性
生成 speech.md
使用 assemble_ppt.py 组装 .pptx

1.10 使用技巧

默认脚本分辨率是 2K 16:9 横屏。如果生成的幻灯片图片比较模糊，尤其是文字较多的页面，可以让当前 agent 改用 4K 分辨率生成图片。
如果只是不满意某一页的内容、排版、配色或文字表达，可以直接让当前 agent 针对这一页做细致修改，不需要整套 PPT 重新生成。
你也可以提供喜欢的 PPT 风格参考，可以是一张截图、多张截图，或完整 PPT/PDF。建议先让当前 agent 分析参考材料的配色、版式、字体和视觉元素，再按这个风格生成新 PPT。生成满意后，也可以让 agent 把这套风格保存到本技能的 references/ 目录里，方便以后复用。
如果需要插入论文原图、实验结果图、截图或架构图，可以在大纲中指定这些图片对应的页码和用途。

2.PPT Master

2.1 生成效果

下载这份带音频旁白的 Attention Is All You Need 论文精读 deck ，在 PowerPoint 里直接放映，每一页都会自己"读"给你听 —— 这只是 PPT Master 能力的冰山一角。

当然，你也可以下载下面六份示例 .pptx 中的任意一份，在 PowerPoint 里打开是最快感受这个项目能力边界的方式。

杂志风	新闻 / 财经数据风	瑞士风

杂志风 — 建筑摄影 + 排版网格，冷静克制的编辑感	新闻 / 财经数据风 — 深色仪表盘，图表驱动，彭博风	瑞士风 — 严格网格，克制字体，红色点缀
在线翻页 · 下载 .pptx	在线翻页 · 下载 .pptx	在线翻页 · 下载 .pptx

毛玻璃 SaaS	孟菲斯波普	Risograph Zine

毛玻璃 SaaS — 半透明叠层，渐变晕染，产品 UI 感	孟菲斯波普 — 高饱和原色，几何图形，俏皮活力	Risograph Zine — 双色印刷质感，手作书店文化
在线翻页 · 下载 .pptx	在线翻页 · 下载 .pptx	在线翻页 · 下载 .pptx

2.2 前置条件

只需装 Python 即可。其余依赖通过 pip install -r requirements.txt 一次装齐。

依赖	是否必须	用途
Python 3.10+	✅ 必需	核心运行时——唯一真正需要安装的东西

一句话总结 — 装好 Python，跑一行 pip install -r requirements.txt，就可以开始生成 PPT 了。
Windows — 请看专门的手把手安装指南
Windows 需要一些额外步骤（PATH 设置、执行策略等）。为 Windows 用户写了一份 手把手安装指南：
- Windows 安装指南 — 从零到跑通第一份 PPT，10 分钟搞定
简要流程：从 python.org 下载 Python → 安装时勾选 “Add to PATH” → pip install -r requirements.txt → 完成。
macOS / Linux — 安装即用
边缘场景备用方案 — 99% 的用户用不到

2.3 选择一个 Agent

PPT Master 在任何具备 agent 能力（可读写文件、执行命令、持续多轮对话）的工具里都能跑。

类型	代表工具	说明
IDE 内置 agent	- VS Code 架构（含 VS Code 本体及分支与衍生）：Cursor、Trae、Codebuddy IDE、Windsurf、Void 等 - 其他架构：Zed 等	编辑器原生集成 agent
IDE 插件 / 扩展	GitHub Copilot、Claude Code（VS Code / JetBrains 扩展）、Cline、Continue、Roo Code、通义灵码、CodeGeex 等	装在 VS Code / JetBrains 等宿主里使用
CLI agent	Claude Code CLI、Codex CLI、Aider、Gemini CLI 等	终端里运行，适合脚本化 / 远程 / 服务器场景

模型推荐：优先选 Claude Opus / Sonnet，搭配大上下文窗口和 gpt-image-2 生图。

2.4 配置项目

方式 A — 下载 ZIP（无需安装 Git）：
GitHub → Code → Download ZIP · AtomGit → 克隆/下载 → 下载 ZIP（国内网速更快）

方式 B — Git clone（需先安装 Git）：

bash

# GitHub
git clone https://github.com/hugohe3/ppt-master.git
# AtomGit（国内网速更快）
git clone https://atomgit.com/hugohe3/ppt-master.git
cd ppt-master

然后安装依赖：

bash

pip install -r requirements.txt

日常更新（方式 A / B）：python3 skills/ppt-master/scripts/update_repo.py

方式 C — Skill marketplace：仓库已添加 .claude-plugin/marketplace.json 元数据，可通过 Claude Code plugin marketplace 生态一行安装：
bash
# 跨 agent CLI (Claude Code, Cursor, Codex 等)
npx skills add hugohe3/ppt-master
claude
# 或在 Claude Code 内
/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master
上述两种安装方式都会拉取 skill 文件本身（不含完整仓库），后处理脚本仍需在安装目录 run pip install -r requirements.txt。

2.5 开始创作

提供原始材料（推荐）： 将 PDF、DOCX、图片等文件放入 projects/ 目录下，在 AI 聊天面板中告诉它使用哪些文件。获取路径的最快方式：在文件管理器或 IDE 侧边栏中右键文件 → 复制路径（Copy Path / Copy Relative Path），直接粘贴进聊天框。

你：请用 `projects/q3-report/sources/report.pdf` 这份文件生成一份 PPT

直接输入内容： 也可以把文字内容直接粘贴进聊天窗口，AI 会根据这些内容生成 PPT。

你：请根据以下内容制作成 PPT：[粘贴你的文字内容...]

两种方式下 AI 都会先确认设计规范：

- AI:好的，先确认设计规范：
 - [模板] B) 自由设计
 - [格式] PPT 16:9
 - [页数] 8-10 页
 - ...

AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。

输出说明：原生形状版 .pptx（可直接编辑）保存至 exports/<name>_<timestamp>.pptx；svg_output/ 始终镜像到 backup/<timestamp>/svg_output/，便于归档或后续重跑。加 --svg-snapshot 时，额外在 exports/ 内并排生成 SVG 快照版 pptx（详见常见问题）。需要 Office 2016+。

2.6 图片获取（可选）

非用户自带图片有两条路径，可在同一份 deck 里按行混用：

需要 API 的功能统一通过 .env 配置。clone 安装可以用 cp .env.example .env；skill marketplace 安装建议使用持久的用户级配置：

bash

mkdir -p ~/.ppt-master
cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.env

PPT Master 会优先读取当前进程环境变量，然后按顺序读取第一个存在的 .env：当前工作目录、clone 仓库根目录、~/.ppt-master/.env。

A) AI 生图 — image_gen.py。设置 IMAGE_BACKEND 和对应 *_API_KEY（OPENAI_API_KEY、GEMINI_API_KEY 等），流程会自动调用。python3 skills/ppt-master/scripts/image_gen.py --list-backends 查看完整后端清单。gpt-image-2 目前综合质量最佳。

B) 网络图片搜索 — image_search.py。零配置可用，但高质量使用建议配置 PEXELS_API_KEY / PIXABAY_API_KEY（都免费申请）。不配置时只使用 Openverse / Wikimedia Commons，适合作为兜底，但容易出现普通用户上传、构图随意、清晰度不稳定的图片；配置后默认搜索链会追加 Pexels / Pixabay，现代商业摄影、人物、办公、生活方式和插画类图片质量会明显更稳定。默认以图片质量和匹配度优先，直接把 CC0、公有领域、Pexels / Pixabay 免署名许可、CC BY、CC BY-SA 一起纳入候选；如果选中的图片需要署名，Executor 会在该幻灯片自动添加小字署名。只有明确不能出现署名时，才使用 --strict-no-attribution 限制为免署名图片。对视觉要求高的封面、产品图、人物图和品牌场景，优先级建议是：用户自带高清素材 / AI 生图 > 配置 Pexels / Pixabay 的网络搜索 > 零配置网络搜索。

完整说明：image-generator.md(AI)、image-searcher.md(网络)

2.7 Windows安装指南

本指南将手把手教你在 Windows 上安装 PPT Master。按顺序操作，10 分钟内即可跑通第一份 PPT。

Step 1 — 安装 Python（必须）

Python 是唯一的硬性要求。

前往 python.org/downloads，下载最新的 Python 3.10+ 安装包。
⚠️ 关键步骤：安装时务必勾选 "Add python.exe to PATH" —— 这是 Windows 上最常见的安装失误，不勾的话后面每一步都会出问题。

Python 安装器 — 勾选 Add to PATH

安装完成后，打开 PowerShell（在开始菜单搜索「PowerShell」）并验证：

powershell

python --version

应该看到Python 3.12.x之类的输出。如果提示「未找到」或弹出 Microsoft Store，见常见问题。

💡 提示：Anaconda / Miniconda 安装的 Python 也可以用，只要 python --version 显示 3.10+ 即可。

Step 2 — 下载项目

方式 A — 下载 ZIP（最简单）：

打开 GitHub（或 AtomGit 镜像，国内更快）
点击绿色 Code 按钮 → Download ZIP
解压到 C:\Users\你的用户名\ppt-master

方式 B — Git Clone（需要 Git）：

bash

# GitHub
git clone https://github.com/hugohe3/ppt-master.git

# AtomGit（国内更快）
git clone https://atomgit.com/hugohe3/ppt-master.git

cd ppt-master

Step 3 — 安装依赖

powershell

cd C:\Users\你的用户名\ppt-master   # ← 替换为你的实际路径
pip install -r requirements.txt

如果 pip 无法识别，用 python -m pip install -r requirements.txt。

等待安装完成，最后看到 Successfully installed ... 就行。

Step 4 — 验证安装

powershell

python -c "import pptx; import fitz; print('All core dependencies OK')"

✅ 输出 All core dependencies OK → 核心环境没问题。

❌ 报错 → 见下方常见问题。

Step 5 — 跑一个最小示例

打开你的 AI 编辑器（Cursor、VS Code + Copilot 等），打开 ppt-master 目录，在聊天面板输入：

text

请创建一个 3 页测试 PPT，封面 + 内容页 + 封底，主题"Hello World"

exports/ 下出现 .pptx 且能在 PowerPoint 中打开 → 搞定了。

Step 6 — 可选增强（大多数用户可以跳过）

装好 Python 和 requirements.txt 后，生成 PPT 的全部功能已经就绪。下面是边缘场景的备用方案和增强项——只有遇到对应的具体场景才需要装。

增强项	只在以下情况才装	安装方式	验证
CairoSVG — 更高质量 PNG 后备图	你希望在不原生支持 SVG 的 Office 版本下获得更清晰的 PNG 后备图。`svglib`（已默认安装）足够大多数场景。	安装 GTK3 Runtime 后 `pip install cairosvg`	`python -c "import cairosvg"`
Pandoc — 旧格式文档	你需要转 `.doc`、`.odt`、`.rtf`、`.tex`、`.rst`、`.org`、`.typ`。 `.docx` / `.html` / `.epub` / `.ipynb` 已由 Python 原生处理。	pandoc.org 下载 `.msi` 安装	`pandoc --version`

2.8 常见问题

(1)`python` 未找到或弹出 Microsoft Store

原因： Python 没有加入系统 PATH。

方法 1 — 重新运行 Python 安装程序，选择 Modify，确保勾选 "Add python to environment variables"。

方法 2 — 手动添加 PATH：

先在 PowerShell 中运行 where python，记下输出的路径（如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exe）
开始菜单搜索「环境变量」
找到 Path → 编辑 → 新增上面路径的目录部分及其 Scripts 子目录：

text

C:\Users\你的用户名\AppData\Local\Programs\Python\Python312
C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts

确定，重启 PowerShell

方法 3 — 试试 python3 或 py 命令。

(2)`pip install` 报权限错误

powershell

pip install --user -r requirements.txt

或以管理员身份运行 PowerShell。

(3)`pip install` 网络问题

powershell

# 清华镜像（国内推荐）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 代理
pip install -r requirements.txt --proxy http://your-proxy:port

(4)`ModuleNotFoundError`

pip 装到了另一个 Python 环境。用 python -m pip install -r requirements.txt 确保对应同一个。

(5)`import fitz` 失败

升级 pip：python -m pip install --upgrade pip
预编译包：pip install PyMuPDF --only-binary :all:
仍失败 → 安装 Visual C++ Build Tools

(6)PowerShell「脚本运行被禁用」

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

还是搞不定？

📖 常见问题 (FAQ)
🐛 GitHub Issues — 附上 Python 版本、Windows 版本和完整报错

3.Nature Skill(绘图、做PPT等科研用途)

nature-skills 是一个可复用指令包仓库，所有 skill 都围绕 SKILL.md 组织。每个 skills/nature-* 目录都是一个可独立安装的单元。

请复制整个文件夹，而不是只复制 SKILL.md，因为很多 skill 还依赖 references/、资源文件、脚本，或 README 中的上下文说明。

3.1. Codex

Codex 可以直接把这些文件夹作为本地 skills 使用，这是最简单的安装方式。

克隆仓库

bash

git clone https://github.com/Yuan1z0825/nature-skills.git
cd nature-skills

安装单个 skill

bash

mkdir -p ~/.codex/skills
cp -R skills/nature-reader ~/.codex/skills/

安装当前所有 skills

bash

mkdir -p ~/.codex/skills
for d in skills/nature-*; do
  cp -R "$d" ~/.codex/skills/
done

更新

bash

git pull
for d in skills/nature-*; do
  cp -R "$d" ~/.codex/skills/
done

重启生效

重启 Codex，让新添加的 skills 生效。
然后用自然语言直接提出需求，例如：translate this paper into a full markdown reader，或 Make this paper into a Chinese journal-club PPT。

如果你不想使用终端，也可以手动把 skills/nature-* 文件夹复制到 ~/.codex/skills。下载：Nature Skill

3.2 Claude Code

主要方式：通过插件市场安装

本仓库已发布为 Claude Code 插件，因此安装会更简单。

bash

# 添加插件市场（只需要执行一次）
/plugin marketplace add https://github.com/Yuan1z0825/nature-skills

# 安装插件
/plugin install nature-skills

# 重新加载插件，使其生效
/reload-plugins

重新加载后，全部 9 个 skills 会自动可用，不需要手动配置 wrapper。

备用方式：subagent wrapper

如果你希望手动控制单个 skill，可以创建一个用户级 subagent：

bash

mkdir -p ~/.claude/agents
cp skills/nature-reader/SKILL.md ~/.claude/agents/nature-reader.md

然后打开 ~/.claude/agents/nature-reader.md，确保 frontmatter 符合 Claude Code subagent 的格式要求：

yaml

---
name: nature-reader
description: Full-paper bilingual, figure-aware, source-grounded Markdown reader for journal or conference papers. Use proactively when the user asks to read, translate, explain, summarize, or convert an academic paper.
---

之后，新建一个 Claude Code 会话，或者打开 /agents，即可自然调用或显式调用它：

text

Use the nature-reader subagent to turn this PDF into a full markdown reader.

如果你更喜欢使用命令，而不是 subagent，可以在 .claude/commands/ 或 ~/.claude/commands/ 下创建项目级或用户级命令，并把对应的 SKILL.md 内容复制或改写进去。

Claude Code 官方文档：

3.3 使用效果

调用nature-skill时，可指定所要使用的skill

等待一段时间，即可得到生成结果

4.SuperPowers(给予AI规范工作流程，提高开发效率)

4.1 工作原理

它从你启动编码 Agent 的那一刻就开始工作。只要它发现你正在构建某个东西，它不会立刻冲进去写代码，而是先退一步，询问你真正想实现的目标。

当它通过对话梳理出一份规格说明后，会把内容分块展示给你。每一块都足够短，便于你真正阅读和消化。

在你确认设计方案之后，Agent 会整理出一份足够清晰的实施计划。这个计划应该清楚到即使交给一个热情很高、但审美一般、判断力不足、缺乏项目背景、还不爱写测试的初级工程师，也能照着执行。它会强调真正的红/绿 TDD、YAGNI（You Aren't Gonna Need It，不做暂时不需要的东西）和 DRY。

接下来，当你说“开始”之后，它会启动一个由 subagent 驱动的开发流程：让多个 Agent 逐项完成工程任务，检查并审阅它们的工作，然后继续向前推进。Claude 按你们制定的计划连续自主工作几个小时，而不偏离方向，这并不罕见。

当然，系统还有更多细节，但这就是核心机制。而且因为 skills 会自动触发，你不需要做任何特殊操作。你的编码 Agent 会直接获得超能力。

4.2 安装

安装方式会因使用的宿主工具不同而不同。如果你同时使用多个宿主工具，需要分别为每一个工具单独安装 Superpowers。

4.2.1 Claude Code

Superpowers 可以通过 Claude 官方插件市场安装。

官方插件市场

从 Anthropic 官方插件市场安装插件：

bash

/plugin install superpowers@claude-plugins-official

Superpowers 插件市场

Superpowers 插件市场提供 Superpowers，以及一些与 Claude Code 相关的其他插件。

注册插件市场：

bash

/plugin marketplace add obra/superpowers-marketplace

从该插件市场安装插件：

bash

/plugin install superpowers@superpowers-marketplace

4.2.2 Codex CLI

Superpowers 可以通过 Codex 官方插件市场安装。

打开插件搜索界面：

bash

/plugins

搜索 Superpowers：

text

superpowers

- 选择 `Install Plugin`。

Codex App

Superpowers 可以通过 Codex 官方插件市场安装。

在 Codex App 中，点击侧边栏里的 Plugins。
你应该能在 Coding 分类中看到 Superpowers。
点击 Superpowers 旁边的 +，然后按提示完成安装。

4.3 基础工作流

brainstorming — 在写代码前触发。它会通过提问打磨粗略想法，探索替代方案，并按章节展示设计供你确认，最后保存设计文档。
using-git-worktrees — 在设计方案获批后触发。它会基于新分支创建隔离工作区，运行项目初始化，并确认测试基线是干净的。
writing-plans — 在设计方案获批后触发。它会把工作拆成小任务（每个任务约 2–5 分钟）。每个任务都包含明确的文件路径、完整代码和验证步骤。
subagent-driven-development 或 executing-plans — 在计划就绪后触发。它会为每个任务派发新的 subagent，并进行两阶段审查：先检查是否符合规格，再检查代码质量；也可以按批次执行，并设置人工检查点。
test-driven-development — 在实现过程中触发。它会强制执行 RED-GREEN-REFACTOR 流程：先写失败测试，确认测试失败，再写最小代码让测试通过，然后提交。测试之前写出的代码会被删除。
requesting-code-review — 在任务之间触发。它会根据计划审查实现，并按严重程度报告问题。严重问题会阻塞继续推进。
finishing-a-development-branch — 在任务完成后触发。它会验证测试，展示后续选项（合并 / PR / 保留 / 丢弃），并清理 worktree。

Agent 会在每个任务开始前检查相关 skills。这些是强制工作流，不是建议。

5.AnySearch

面向 AI Agent 的统一实时搜索引擎技能。支持通用网页搜索、垂直领域搜索、并行批量搜索，以及整页内容提取。

5.1 面向 AI Agent

如果你的 Agent 平台支持技能市场或插件商店，请搜索 anysearch 并从那里安装。否则，可以手动下载并安装：

bash

# 下载（建议固定到某个具体发布版本）
curl -L -o anysearch-skill.zip https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip
# 或者：
wget -O anysearch-skill.zip https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip

# 校验完整性（将校验值替换为发布页面提供的实际 checksum）
# sha256sum anysearch-skill.zip

# 解压
unzip anysearch-skill.zip

# 移动到你的 Agent 技能目录
# 以下为示例路径，请根据你的 Agent 调整

# Claude Code:
mv anysearch-skill ~/.claude/skills/anysearch

# OpenCode:
mv anysearch-skill ~/.config/opencode/skills/anysearch

# Cursor / Windsurf:
mv anysearch-skill <project>/.skills/anysearch

# 通用路径：
mv anysearch-skill <your_agent_skill_dir>/anysearch

# 共享 Agent 路径：
mv anysearch-skill ~/.agents/skills/anysearch

~/.agents/skills/ 是一个实用的共享安装位置。当多个 AI 工具从同一个技能目录读取技能时，可以使用该路径，例如 Codex、Cursor，以及 OpenClaw 个人 Agent 技能。

5.2 面向普通用户

下载 zip 文件：
https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip
解压到你的 Agent 技能目录。
配置 API Key，见下文。
运行入口测试，验证安装是否成功。

5.3 API Key 配置

API Key 是可选的，但强烈建议配置。
如果没有 API Key，你仍然可以通过匿名访问使用所有搜索功能，但会受到更低的速率限制和配额限制。

5.3.1 如何配置

复制示例环境变量文件，并填入你的 API Key：

bash

cp .env.example .env
# 编辑 .env 并设置：
# ANYSEARCH_API_KEY=<your_api_key_here>

或者直接设置环境变量：

bash

export ANYSEARCH_API_KEY=<your_api_key_here>     # Linux / macOS
set ANYSEARCH_API_KEY=<your_api_key_here>        # Windows CMD
$env:ANYSEARCH_API_KEY="<your_api_key_here>"     # Windows PowerShell

5.3.2 获取 API Key

访问以下地址注册并创建免费的 API Key：

https://anysearch.com/console/api-keys

API Key 优先级顺序：

text

--api_key CLI 参数 > .env 文件 > 环境变量 > 匿名访问

5.4 安装后验证

安装完成后，检测平台环境并运行入口测试：

5.4.1 步骤 1：检测可用运行时

按顺序运行以下检查。第一个成功的检查将决定当前可用的 CLI：

bash

# 检查 Python（推荐）
python --version    # 需要 >= 3.6，并且需要 `requests` 库
python3 --version   # 需要 >= 3.6，并且需要 `requests` 库

# 检查 Node.js（备选）
node --version      # 需要 >= 12，无外部依赖

# 检查 Shell（兜底）
# Windows: PowerShell 5.1+
# Linux/macOS: bash 4+

优先级：

text

Python > Node.js > Shell

重要说明：不要假设系统中一定存在 python。在许多 macOS 系统中，正确的可执行文件是 python3。请同时检查 python 和 python3；只要其中一个可用，就表示 Python 可用。

5.4.2 步骤 2：运行入口测试

使用每个可用运行时执行 doc 命令，以验证技能是否正常工作，并观察哪个运行时没有错误或警告：

bash

# Python
python <skill_dir>/scripts/anysearch_cli.py doc

# Python 3 兜底方案（macOS 上较常见）
python3 <skill_dir>/scripts/anysearch_cli.py doc

# Node.js（如果可用）
node <skill_dir>/scripts/anysearch_cli.js doc

# PowerShell（Windows）
powershell -ExecutionPolicy Bypass -File <skill_dir>/scripts/anysearch_cli.ps1 doc

# Bash（Linux/macOS）
bash <skill_dir>/scripts/anysearch_cli.sh doc

对于每个运行时，请记录命令是否成功，以及是否出现错误或警告。能够无错误完成，并且输出最干净的运行时，就是当前环境推荐使用的运行时。

5.4.3 步骤 3：将推荐运行时写入配置文件

根据入口测试结果，将推荐运行时写入：

text

<skill_dir>/runtime.conf

通用写法：

bash

echo "Runtime: <RUNTIME>" > <skill_dir>/runtime.conf
echo "Command: <COMMAND>" >> <skill_dir>/runtime.conf

Python 示例：

bash

echo "Runtime: Python" > <skill_dir>/runtime.conf
echo "Command: python <skill_dir>/scripts/anysearch_cli.py" >> <skill_dir>/runtime.conf

Python3 示例：

bash

echo "Runtime: Python3" > <skill_dir>/runtime.conf
echo "Command: python3 <skill_dir>/scripts/anysearch_cli.py" >> <skill_dir>/runtime.conf

Node.js 示例：

bash

echo "Runtime: Node.js" > <skill_dir>/runtime.conf
echo "Command: node <skill_dir>/scripts/anysearch_cli.js" >> <skill_dir>/runtime.conf

PowerShell 示例：

bash

echo "Runtime: PowerShell" > <skill_dir>/runtime.conf
echo "Command: powershell -ExecutionPolicy Bypass -File <skill_dir>/scripts/anysearch_cli.ps1" >> <skill_dir>/runtime.conf

Bash 示例：

bash

echo "Runtime: Bash" > <skill_dir>/runtime.conf
echo "Command: bash <skill_dir>/scripts/anysearch_cli.sh" >> <skill_dir>/runtime.conf

重要说明：运行时偏好配置保存在 runtime.conf 中，而不是 SKILL.md 中。Agent 在加载技能时会读取 runtime.conf，以确定当前使用的 CLI。如果该文件缺失或损坏，Agent 会回退到 SKILL.md 中的“平台检测”流程。如果 runtime.conf 已经存在，请直接替换它，而不是追加内容。

5.5 Codex Cli演示Anysearch

5.5.1 Codex Cli输入安装指令

打开Codex Cli，终端输入如下指令，安装好后重启Codex

bash

 $skill-installer install https://github.com/anysearch-ai/anysearch-skill

5.5.2 前往AnySearch官网找到API key

前往AnySearch注册登录，然后创建API key

5.5.3 Codex切换目录到AnySearch文件夹操作

在Codex Cli中输入：

bash

cd ~\.codex\skills\anysearch-skill

复制.env.example这个文件，输入：

bash

cp.env.example.env

然后把API Key编辑进去

第一次使用AnySearch先输入doc命令获取Skill所支持的命令与参数

bash

$anysearch run doc

输入'$anysearch'然后加上指令，即可运行

6.Skill Creator

每一种 AI 编程工具——Claude Code、GitHub Copilot、Cursor、Windsurf、Codex、Gemini、Kiro 等等——都是从零开始的。它不了解你公司的流程、数据源或合规要求。因此，每个人都要在每次对话中重新解释同样的工作流。知识停留在个人聊天记录里。新人也必须从头开始。

Agent 技能可以解决这个问题。 技能是一种结构化知识，Agent 会自动加载它——就像安装一个应用一样。安装完成后，团队中的任何人都可以调用它，并且在任何平台上每次都获得一致的结果。

问题在于： 构建一个合格的技能，需要理解规范格式、编写清晰的提示指令、设计信息如何渐进加载、编写功能代码，并正确设置激活关键词。即使是简单技能，也通常需要多轮迭代才能做好。

Agent Skill Creator 完全移除了这个门槛。 你可以把任何已有材料交给它——混乱的文档、链接、代码、PDF、转录文本、模糊描述——它会生成一个经过验证、安全扫描、可安装到 14+ 种工具并可与团队共享的技能。你只需要描述你要做什么；它负责构建软件。

6.1 安装

选项 A：一行命令安装（安装到所有检测到的工具）：

bash

curl -fsSL https://raw.githubusercontent.com/FrancyJGLisboa/agent-skill-creator/main/scripts/bootstrap.sh | bash

这会克隆到：

text

~/.agents/skills/agent-skill-creator

并为每个检测到的全局平台创建符号链接，例如 Claude Code、Gemini CLI、Goose、OpenCode、Copilot。之后只需要运行一次：

bash

git pull

即可在所有位置更新。

选项 B：Git 克隆（选择你的工具）：

bash

# Claude Code / VS Code Copilot
# 全局安装，适用于所有项目
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.claude/skills/agent-skill-creator

# Cursor
# 按项目安装
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git .cursor/rules/agent-skill-creator

# Codex CLI / Gemini CLI / Kiro / Antigravity
# 通用路径
git clone https://github.com/FrancyJGLisboa/agent-skill-creator.git ~/.agents/skills/agent-skill-creator

选项 C：已经克隆？为所有工具创建符号链接：

bash

cd agent-skill-creator

./install.sh              # 为所有检测到的平台创建符号链接
./install.sh --dry-run    # 预览，不实际修改
./install.sh --uninstall  # 移除所有符号链接

一次安装到：

text

~/.claude/skills/

可同时适用于 Claude Code 和 VS Code Copilot。

一次安装到：

text

~/.agents/skills/

可适用于 Codex CLI、Gemini CLI、Kiro、Antigravity，以及其他读取通用路径的工具。

6.2 使用

打开你的 Agent，输入 /agent-skill-creator，后面接上你已有的材料或需求：

text

/agent-skill-creator Every week I pull sales data from our CRM, clean
duplicate entries, calculate regional totals, and generate a PDF report.

你可以传入任何内容：普通英文描述、文档链接、现有代码、API 文档、PDF、数据库 schema、会议转录等。也可以在同一条消息里组合多个来源。上下文越充分，生成效果越好。

text

/agent-skill-creator Based on our deployment runbook: https://wiki.internal/deploy-process

text

/agent-skill-creator See scripts/invoice_processor.py — turn it into a reusable skill

6.3 生成结果

它会生成一个完整技能，并自动安装到你的平台：

text

Skill installed successfully.

To use it, open a new session and type:

  /sales-report-skill Generate the weekly report for the West region

Installed at: ~/.claude/skills/sales-report-skill

Agent 会自动识别你的平台，把技能安装到正确位置，并告诉你具体如何调用。无需手动配置。

生成的技能还包含一个跨平台安装脚本：install.sh，该脚本会自动检测全部 14 个受支持的工具，为 Cursor 生成 .mdc 格式适配文件，为 Windsurf 生成 .mdrules 格式适配文件，并创建通用的：~/.agents/skills/符号链接，使多个工具可以同时发现并使用该技能。

7.WeChat Chat Analyzer Skill使用教程

一个 AI Agent Skill，能自动解密提取与特定用户的聊天记录，用于深度分析，并可生成互动习惯报告、情感走势、性格画像等，并支持追问细节。

7.1 系统要求

操作系统: Windows 10/11 (推荐), macOS (需手动准备数据)
Python: 3.8 或更高版本
权限: Windows 用户需要管理员权限
微信: 电脑版微信 4.0+

将 wechat-chat-analyzer 目录复制到你的 AI Agent 软件的 skills 目录下即可。

例如：打开C盘找到用户目录，然后找到.codex文件夹

点击.codex文件夹，找到.skills目录

7.2 安装步骤

7.2.1 克隆仓库

PowerShell

git clone https://github.com/UniUni2000/wechat-chat-analyzer.git

7.2.2 复制到 skills 目录（以 Codex 为例）

PowerShell

cp -r wechat-chat-analyzer/wechat-chat-analyzer ~/.codex/skills/

7.2.3 安装依赖

PowerShell

pip install -r wechat-chat-analyzer/requirements.txt

如果 py -m pip --version 有输出，直接用这个安装依赖：
PowerShell
py -m pip install -r wechat-chat-analyzer/requirements.txt

7.3 使用方法

安装完成后，直接对你的 AI Agent 说（注意，一定要以管理员方式启动 agent 进程）：

"分析我和 [好友名字] 的微信聊天记录" AI 会自动完成：提取微信数据 → 运行分析 → 生成报告 → 与你讨论结果

7.4 输出文件

分析完成后，会在输出目录生成以下文件：

analysis_report.json - 完整的分析报告（JSON 格式）
chat_export.txt - 纯文本聊天记录
chat_export.csv - 结构化 CSV 文件
chat_export.html - 微信气泡对话风格（可截图分享）
wordcloud*.png - 词云图片
trend.png - 消息量趋势图
monthly_bar.png - 月度消息量对比柱状图
heatmap.png - 聊天频率热力图
reply_speed.png - 回复速度分析图

7.5 故障排查

问题	解决方案
权限不足	Windows 用户请以管理员身份运行 AI Agent
微信进程未找到	确保微信已登录并保持运行
数据库解密失败	重启微信和 AI Agent 后重试
未找到聊天记录	确认好友名称正确，或尝试使用 wxid
macOS 数据目录找不到	手动检查 `~/Library/Containers/com.tencent.xinWeChat/...` 路径

更多故障排查参考：https://github.com/UniUni2000/wechat-chat-analyzer/blob/main/wechat-chat-analyzer/references/troubleshooting.md

8.童锦程Skill

「真诚才是最高级的套路。真诚你不一定会得到爱，但是你不真诚，你一定会失去爱。」

让深情祖师爷童锦程用他的直白和人性洞察，帮你看透关系、读懂人心。

8.1 情感问题分析示例

用户：

我喜欢一个女孩，她对我时好时坏，有时候聊得很好，
有时候又不回消息。我不知道她喜不喜欢我。

童锦程：

我就说一句，你仔细听——如果你不确定她喜不喜欢你，
那她就是不喜欢你。
真正喜欢你的人，你不会有这个问题。
她对你忽冷忽热，不是因为她复杂，是因为你对她来说不重要。
重要的事情人家不会这样，知道吗？
别继续纠结了，兄弟。去充实自己。
你若盛开，蝴蝶自来。

用户：

我想测试一下男朋友，故意不联系他，看他会不会主动找我。

童锦程：

人性经不起考验。
他主动找你，你得到的是一个被测试过的结果，
不是更爱你。他没找你，关系就破裂了。
你亲手把关系放在了最容易断的地方。
你真正的问题不是他对你不用心，
是你没把你的需求直接说出来。
“我希望你多联系我，这对我很重要”——
这句话说了吗？
没说，就别测试。直接说，才是正路。是不是？

用户：

我事业刚起步，女朋友说我花太多时间工作，
不顾她。怎么平衡？

童锦程：

说实话兄弟，事业起步的时候你没有平衡，
你只有取舍。
但这不是说放弃她。先把这件事跟她说清楚：
“我现在这段时间很关键，我需要你的理解，
但我不会消失，我会给你确定的时间和承诺。”
女孩怕的不是你忙。女孩怕的是你忙到忘记她了。
你忙，但你记得说过的话，记得她的安全感——
这才是关键。
当兵后悔三年，不当后悔一辈子。
事业要做，但真正牵手的人也别让她跑了。

这不是角色扮演。童锦程用的是【不确定即不喜欢】、【人性不可考验】、【给准备时间不突袭】这些真实的认知框架在帮你分析——不是复读语录，是用他的思维方式帮你看问题。

8.2 安装

bash

npx skills add hotcoffeeshake/tong-jincheng-skill

然后在 Claude Code 里用以下关键词触发：

text

> 童锦程
> 深情训练
> 用童锦程的方式
> 从童锦程视角
> 锦程怎么看

激活后，可以直接提问：

text

> 我暗恋同事半年了，一直没开口，怎么办
> 他对我不冷不热，我该怎么看
> 我想追一个女孩，但不知道她有没有男朋友

8.3他蒸馏了什么

童锦程不是学院派，是街头智慧提炼者。他的核心认知框架提取自20万字一手素材：

心智模型	一句话
吸引力 > 讨好	没有人会因为你喜欢他而喜欢你，别人只会因为你吸引他而喜欢你
给台阶	人不是不想做，而是需要一个能说服自己的理由——你的工作是给他这个理由
人性不可考验	人性经不起考验，与其测试，不如给他条件让他表现好
炫耀即暴露不安全感	越缺什么越想炫耀什么——人的炫耀永远指向他的不安全感
成功前后是两个世界	成功之后身边全是好人，没钱的时候也全是“好人”——这不是悲观，是实话

9条决策启发式，包括：

如果你不确定她喜欢你，那她就是不喜欢你
遇到瓶颈：读书或健身，永远不喝酒
生气解决不了问题，想解决办法才是正路
钱花在真正的人身上，不花在萍水之交的表演上

8.4 诚实边界

这个 Skill 能做的：

用童锦程的人际洞察框架分析关系问题
模拟他的直接、白聊式表达风格
提供他在恋爱 / 人际 / 个人成长领域的视角

做不到的：

维度	说明
商业决策	素材几乎全是情感内容，直播带货 / 创业策略数据严重不足
替代本人	他的当下状态、最新想法、真实私下性格无法被复制
2025 年后新动态	联网受限，最新信息可能有缺漏
辛巴关系细节	他本人从不公开说，素材不足

Skill 安装使用教程 ​

1.Codex PPT Skill ​

1.1 GitHub作者温馨提示 ​

1.2 特点 ​

1.3 生成效果 ​

1.4 风格示例 ​

1.5 输出结构 ​

1.6 适用场景 ​

1.7 安装 ​

1.8 生图模型配置 ​

1.9 使用方式 ​

1.10 使用技巧 ​

2.PPT Master ​

2.1 生成效果 ​

2.2 前置条件 ​

2.3 选择一个 Agent ​

2.4 配置项目 ​

2.5 开始创作 ​

2.6 图片获取（可选） ​

2.7 Windows安装指南 ​

2.8 常见问题 ​

(1)python 未找到或弹出 Microsoft Store ​

(2)pip install 报权限错误 ​

(3)pip install 网络问题 ​

(4)ModuleNotFoundError ​

(5)import fitz 失败 ​

(6)PowerShell「脚本运行被禁用」 ​

还是搞不定？ ​

3.Nature Skill(绘图、做PPT等科研用途) ​

3.1. Codex ​

3.2 Claude Code ​

3.3 使用效果 ​

4.SuperPowers(给予AI规范工作流程，提高开发效率) ​

4.1 工作原理 ​

4.2 安装 ​

4.2.1 Claude Code ​

4.2.2 Codex CLI ​

4.3 基础工作流 ​

5.AnySearch ​

5.1 面向 AI Agent ​

5.2 面向普通用户 ​

5.3 API Key 配置 ​

5.3.1 如何配置 ​

5.3.2 获取 API Key ​

5.4 安装后验证 ​

5.4.1 步骤 1：检测可用运行时 ​

5.4.2 步骤 2：运行入口测试 ​

5.4.3 步骤 3：将推荐运行时写入配置文件 ​

5.5 Codex Cli演示Anysearch ​

5.5.1 Codex Cli输入安装指令 ​

5.5.2 前往AnySearch官网找到API key ​

5.5.3 Codex切换目录到AnySearch文件夹操作 ​

6.Skill Creator ​

6.1 安装 ​

6.2 使用 ​

6.3 生成结果 ​

7.WeChat Chat Analyzer Skill使用教程 ​

7.1 系统要求 ​

7.2 安装步骤 ​

7.2.1 克隆仓库 ​

7.2.2 复制到 skills 目录（以 Codex 为例） ​

7.2.3 安装依赖 ​

7.3 使用方法 ​

7.4 输出文件 ​

7.5 故障排查 ​

8.童锦程Skill ​

8.1 情感问题分析示例 ​

8.2 安装 ​

8.3他蒸馏了什么 ​

8.4 诚实边界 ​

Skill 安装使用教程

1.Codex PPT Skill

1.1 GitHub作者温馨提示

1.2 特点

1.3 生成效果

1.4 风格示例

1.5 输出结构

1.6 适用场景

1.7 安装

1.8 生图模型配置

1.9 使用方式

1.10 使用技巧

2.PPT Master

2.1 生成效果

2.2 前置条件

2.3 选择一个 Agent

2.4 配置项目

2.5 开始创作

2.6 图片获取（可选）

2.7 Windows安装指南

2.8 常见问题

(1)`python` 未找到或弹出 Microsoft Store

(2)`pip install` 报权限错误

(3)`pip install` 网络问题

(4)`ModuleNotFoundError`

(5)`import fitz` 失败

(6)PowerShell「脚本运行被禁用」

还是搞不定？

3.Nature Skill(绘图、做PPT等科研用途)

3.1. Codex

3.2 Claude Code

3.3 使用效果

4.SuperPowers(给予AI规范工作流程，提高开发效率)

4.1 工作原理

4.2 安装

4.2.1 Claude Code

4.2.2 Codex CLI

4.3 基础工作流

5.AnySearch

5.1 面向 AI Agent

5.2 面向普通用户

5.3 API Key 配置

5.3.1 如何配置

5.3.2 获取 API Key

5.4 安装后验证

5.4.1 步骤 1：检测可用运行时

5.4.2 步骤 2：运行入口测试

5.4.3 步骤 3：将推荐运行时写入配置文件

5.5 Codex Cli演示Anysearch

5.5.1 Codex Cli输入安装指令

5.5.2 前往AnySearch官网找到API key

5.5.3 Codex切换目录到AnySearch文件夹操作

6.Skill Creator

6.1 安装

6.2 使用

6.3 生成结果

7.WeChat Chat Analyzer Skill使用教程

7.1 系统要求

7.2 安装步骤

7.2.1 克隆仓库

7.2.2 复制到 skills 目录（以 Codex 为例）

7.2.3 安装依赖

7.3 使用方法

7.4 输出文件

7.5 故障排查

8.童锦程Skill

8.1 情感问题分析示例

8.2 安装

8.3他蒸馏了什么

8.4 诚实边界