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 的使用说明。

场景	Skill / 使用说明	用途	额外依赖
写作	mufeng-blog-writing	技术博客、教程和排错文章	素材；核实事实时需网络检索
写作	mufeng-dankoe-writing	Dan Koe 风格长篇写作	无专用工具
发布	mufeng-wechat-publish-full	完成文章的配图、上传和公众号发布	生图工具、gh、Bun、发布工具与凭据
发布	mufeng-materials-to-wechat-publish	目录素材转公众号文章	博客 skill、网络检索；生图和发布依赖同上
绘本	mufeng-bilingual-storybook	中英文插画绘本与 PDF	Python、Pillow、pypdfium2、生图/视觉工具；默认 PDF 字体需 macOS
阅读	mufeng-book-notes	可落地的读书笔记	真实摘录或读书材料
阅读	mufeng-weread-x-writing	阅读记录提炼原创 X 推文	Python；微信读书工具或真实导出材料
复盘	mufeng-weekly-report	周报与行动建议	当前对话或用户提供的周记录
复盘	mufeng-monthly-report	月度趋势与行动计划	当前对话或用户提供的月记录
思考	mufeng-brainstorm	发散、筛选和反驳	子代理可选；缺少时注明顺序检查
思考	mufeng-virtual-team	CTO / 产品 / 用户多视角评审	功能描述与项目背景
设计	mufeng-logo	原创 Logo、字标与组合，含矢量源及单色/小尺寸检查	可用的渲染与图片查看工具；生图、字体转曲工具按需
设计	mufeng-app-icon	App icon 概念、精修、多尺寸预览与平台适配	Python + Pillow（预览）；生图工具可选；集成验证需 Xcode
设计	mufeng-ios-design	原生 iOS UI 优化、App icon 与原创 logo，含实际验证	项目源码；原生验证需 macOS + Xcode；生图工具可选
设计	mufeng-uxreview	UI/UX 评审	页面代码，必要时提供截图
iOS	mufeng-ios-release-audit	上线审计与上线文案	iOS 项目；编译需 macOS + Xcode
iOS	mufeng-ios-visual-regression	多语言与明暗截图对比	macOS + Xcode + Simulator、Python、Pillow、应用 harness
调试	mufeng-parallel-root-cause	证伪式根因调查	日志和实验工具；并行需子代理
研究	mufeng-stock-research	股票研究与报告导出	网络检索；MCP 可选；导出需 Pandoc，PDF 需 Chrome/Chromium
研究	mufeng-ios-app-opportunity	App Store 竞品差评与低竞争方向挖掘	Python 3.10+、可访问 itunes.apple.com；无需账号
iOS	mufeng-ios-app-naming	App 英文名生成，以及 App Store、商标、域名、网站的五步查重	Python 3.9+、可访问 App Store / USPTO / TMview / RDAP；网页检索工具；日本商标需手动查
研发	mufeng-app-builder	产品想法 → PRD、验收、AGENTS.md/CLAUDE.md、任务图，可选自主开发到 MVP	Python 3.9+；build 模式需目标技术栈工具链（iOS 需 macOS + Xcode）

生图、发布、阅读数据和历史会话的配置与限制，见 兼容性文档。

目录与维护

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。