yuczzzzz/nuwa-skill-codex

[!IMPORTANT] 本文档由 AI 基于当前仓库内容生成并整理。如有纰漏，欢迎通过 Issue 或 PR 支持修正。

这是基于上游项目 alchaincyf/nuwa-skill 的 Codex 适配版。原始项目作者为 Huashu（花叔），当前适配与维护者为 yuc。本仓库用于适配 Codex 的工作流与目录约定，不是原作者的官方发布版本。

它保留了原版最核心的方法论：

• 输入明确人名或主题，直接蒸馏
• 输入模糊困惑，先诊断需求，再推荐最合适的思维框架
• 用多源调研提取心智模型、决策启发式、表达 DNA、价值观、反模式和诚实边界
• 生成可运行的 *-perspective 或 *-framework skill，而不是名人语录拼贴

同时，它把平台相关部分改成了 Codex 的约定：

• 技能目录改为 $CODEX_HOME/skills 或 ~/.agents/skills/
• 子代理工作流改为 spawn_agent
• 联网检索改为当前会话可用的 web / 浏览能力
• 无多代理能力时，支持按同样拆分顺序串行降级

来源与署名

• 上游项目： alchaincyf/nuwa-skill
• 原始项目作者：Huashu（花叔）
• Codex 适配与维护：yuc
• 当前仓库定位：由 yuc 维护的 Codex 适配版
• 发布原则：保留上游作者署名，不将当前仓库表述为原作者官方版本

它解决的不是“模仿名人”

女娲蒸馏的是认知操作系统，不是口头禅。

一个好的人物 skill 至少要能回答六个问题：

• 这个人用什么心智模型看世界
• 他用什么决策启发式快速判断
• 他在表达上有什么稳定 DNA
• 他明确反对什么
• 他内部有哪些张力和矛盾
• 这个 skill 明确做不到什么

如果只能模仿语气，那是角色扮演，不是可用的思维框架。

Codex 使用方式

安装位置

任选一种：

1. 安装到 $CODEX_HOME/skills/nuwa-skill
2. 安装到 ~/.codex/skills/nuwa-skill
3. 如果你的 Codex 通过原生发现读取 ~/.agents/skills/，把该目录软链接到 ~/.agents/skills/nuwa-skill

如果使用多代理流程，确保 Codex 已开启多代理能力。

目录结构

nuwa-skill/
├── SKILL.md
├── README.md
├── LICENSE
├── references/
│   ├── extraction-framework.md
│   └── skill-template.md
└── scripts/
    ├── download_subtitles.sh
    ├── merge_research.py
    ├── quality_check.py
    └── srt_to_transcript.py

examples/ 没有迁移到这个 Codex 版本，详见上游项目 alchaincyf/nuwa-skill。

典型触发

下面这类请求适合直接触发女娲：

• 蒸馏一个保罗·格雷厄姆
• 做一个张小龙的视角 skill
• 更新一下我之前做的芒格 skill
• 我总觉得自己商业判断不稳定，有没有一个适合我的思维顾问
• 我想做一个主题 skill，不是人物，是“反脆弱决策”

工作流概览

1. Phase 0: 判断是直接蒸馏还是先诊断需求。
2. Phase 0.5: 创建目标 skill 目录，约束所有调研文件必须内聚在 skill 内部。
3. Phase 1: 按著作、对话、表达、他者、决策、时间线六个维度采集信息。
4. Phase 1.5: 做调研质量检查，确认来源数量、关键发现、信息缺口和矛盾点。
5. Phase 2: 用三重验证提炼心智模型。
6. Phase 2.5: 展示提炼摘要，确认方向没偏。
7. Phase 3: 按模板组装最终 SKILL.md。
8. Phase 4: 用已知问题、边缘问题和风格测试验证质量。
9. Phase 5: 做双 reviewer 精炼，提升激活触发、工作流和边界条件的可执行性。

参考文件

• references/extraction-framework.md: 如何判断一个观点是真心智模型而不是随口一说
• references/skill-template.md: 生成人物或主题 skill 的模板骨架
• scripts/merge_research.py: 汇总六路调研结果
• scripts/quality_check.py: 检查心智模型数量、边界、张力等质量项

适配说明

这个目录不是对 Claude Code 版的逐字复制，而是做了以下 Codex 化处理：

• 把所有 .claude/skills/... 路径抽象为 ``
• 把 subagent / Task 思维模型替换为 spawn_agent
• 把 WebSearch 替换为当前会话可用的联网工具
• 在流程中增加“无多代理时的串行降级”约定
• 保留 references/ 和 scripts/，因为这些是方法论和执行辅助，不是平台耦合物

许可

本仓库沿用上游 MIT 协议，详见 LICENSE。

如果你继续分发或二次改造，请保留原始版权声明与许可声明，并在文档中明确区分「原始项目作者」与「当前适配版 / 衍生版维护者」。