Mufeng AI Skills
面向 Codex 和 Claude Code 的开源技能集，覆盖内容创作、阅读整理、研发协作和应用检查。
由沐风（Joey）维护，共 22 个 skill，涵盖写作与发布、阅读与复盘、思考与决策、iOS 工程和研究分析。
两端共用 skills/ 中的同一份内容。
生图、账号数据和发布需要额外配置工具与凭据。
快速安装
需要 Git 和 Python 3.10+。默认同时安装到两端的用户目录，不覆盖已有同名 skill：
git clone https://github.com/ichangyou/mf-ai-skills.git
cd mf-ai-skills
python3 scripts/install.py --platform both --scope user
默认使用软链接，保留仓库即可通过 git pull 更新。Windows 或不支持软链接时加 --mode copy。
只安装一个 skill：
python3 scripts/install.py --platform both --skill mufeng-book-notes
项目级安装、冲突处理、更新与卸载见 安装文档。当前采用直接安装方式，没有 Claude Code marketplace。
怎么调用
| Codex | Claude Code |
|---|
$mufeng-book-notes 根据这份摘录生成读书笔记 | /mufeng-book-notes 根据这份摘录生成读书笔记 |
也可用自然语言明确要求使用 skill。安装后未出现时，重新加载 skills 或重启客户端。
有哪些 skill，需要什么依赖
下表列的是执行条件，不表示外部服务已经完成端到端验证。详细示例见各 skill 的使用说明。
生图、发布、阅读数据和历史会话的配置与限制，见 兼容性文档。
目录与维护
skills/<name>/ # 唯一内容来源
SKILL.md # AI 执行说明与元数据
README.md # 用户使用说明
references/ # 详细规则（可选）
scripts/ # 辅助脚本（可选）
assets/ # 图片、模板（可选）
agents/openai.yaml # Codex UI 元数据（可选）
.agents/skills/<name> # Codex 项目入口 → skills/<name>
.claude/skills/<name> # Claude Code 项目入口 → skills/<name>
docs/ # 安装和兼容性说明
scripts/ # 安装、校验和打包工具
examples/ # 可选 API 示例和历史格式
tests/ # 安装与兼容性回归测试
开发检查：
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python scripts/validate.py
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python -m unittest discover -s skills/mufeng-bilingual-storybook/tests -v
.venv/bin/python -m unittest discover -s skills/mufeng-ios-app-opportunity/tests -v
.venv/bin/python -m unittest discover -s skills/mufeng-ios-app-naming/tests -v
.venv/bin/python -m unittest discover -s skills/mufeng-app-builder/tests -v
.venv/bin/python -m unittest discover -s skills/mufeng-app-icon/tests -v
Windows 使用 .venv\Scripts\python.exe。绘本 PDF 测试使用 macOS 默认字体。
校验覆盖元数据、两端入口、目录索引和本地链接；业务效果与外部服务需要真实环境验证。
贡献约定见 CONTRIBUTING.md。
许可证
MIT © Chang You，见 LICENSE。
