shuohao-skills：给 AI 编码 agent 用的 skill 集合（Claude Code 和 codex 均可运行）
shuohao-skills 是一个面向 AI 编码 agent 的 skill 集合，目前主要提供 novel-characters 技能，可将小说拆解为角色设定集，包含人物画像、卡通形象提示词、音色提示词和角色设定图。仓库自带安装脚本，支持 Claude Code 与 codex，每个 skill 自包含且有零依赖自测脚本，基于 Apache 2.0 开源。
适用大模型
社区作者 · Aitroys 管理员
它解决什么问题
该仓库是一个 AI 编码 agent 的技能集合，适用于 Claude Code 和 codex。核心技能为 novel-characters，能够将一篇小说自动拆解为完整的角色设定集，输出人物画像、卡通形象提示词、音色提示词以及角色设定图。报告语言与出图风格可选。所有 skill 按目录自包含，每个目录包含 SKILL.md（给 agent 读的工作流）、README.md（给人读的说明）、scripts/ 下的确定性工具和自测脚本、references/（按需加载的详细指令）、examples/（样例与测试夹具）以及 assets/（截图）。仓库要求每个 skill 必须有 SKILL.md 和 scripts/selftest.mjs，自测不调用模型、不花费额度，覆盖全部确定性逻辑。安装时通过
git clone 克隆仓库后运行 install.sh，脚本会自动检测本机安装的是 Claude Code 还是 codex，并将 skill 软链过去，
git pull 后即可生效，无需重装。也支持只安装指定 skill、只安装到 codex 或卸载。前置条件要求 Node ≥ 18（skill 脚本只用标准库，零 npm 依赖）、模型额度（使用当前会话额度，无需 API key）；codex CLI 为可选，只有出图功能需要（走内置 $imagegen），没有可跳过出图，其余产出照常。仓库仅在 macOS + Node 24 上验证过，代码无平台相关调用，Linux 和更低版本 Node 理论上可行。作者还开设了 AI 短剧交流群（付费），微信 hao_dev，添加时备注 github。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
步骤 1 · 克隆仓库：
git clone https://github.com/eternityspring/shuohao-skills.git步骤 2 · 进入目录：
cd shuohao-skills步骤 3 · 运行安装脚本：
./scripts/install.sh- 脚本会自动检测本机安装的是 Claude Code 还是 codex，并把所有 skill 软链到对应目录。软链后 git pull 即可生效，不需要重新安装。
- 可选参数：
只装某一个 skill：
./scripts/install.sh novel-characters只装到 codex：
./scripts/install.sh --codex取消软链（卸载）：
./scripts/install.sh --uninstall- 不想用脚本，也可以手动软链：
- ln -s " $PWD /skills/novel-characters " ~ /.claude/skills/novel-characters
- ln -s " $PWD /skills/novel-characters " ~ /.codex/skills/novel-characters
- 前置条件：
- Node ≥ 18（skill 脚本只用标准库，无 npm 依赖，无需 install）
- 模型额度（使用当前会话额度，不需要任何 API key）
- codex CLI 可选（出图才用得上，走内置 $imagegen；没有就跳过出图，其余产出照常）
- 常见问题：
- 软链后新 skill 不生效？确认 git pull 后重新运行 install.sh，或检查软链路径是否正确。
- 出图功能不可用？确认已安装 codex CLI 且当前环境支持 $imagegen；没有 codex 时可跳过出图，其他结果正常。
- Node 版本过低？需升级到 Node 18 或以上。
- 在其他平台运行？仓库仅在 macOS + Node 24 上验证，Linux 和更低 Node 版本理论上可行，但未经过验证。
适用场景
Skill 讨论与实践反馈
0还没有讨论
分享一条可复现的补充、问题或使用经验。