yaojingang/yao-open-skills

Yao Open Skills

是什么 – 一个精心挑选的开源 AI「技能」（结构化提示+代码工作流）集合，将现实世界任务——如决策分析、商业建模、安全审计、教程生成、阅读报告可视化等——转化为可复现、可评估的成果物。每个技能位于独立文件夹中，包含 SKILL.md 入口文件、源代码脚本、参考材料以及可直接导出的报告（Markdown、HTML、DOCX、PDF、JSON 等）。

为何重要 – 与松散的提示堆叠不同，该项目将技能视为第一类软件资产：可复用、可维护、可评估。这与更广泛的 YAO（Yielding AI Outcomes）方法论一致，强调交付具体、可交付的成果，而非无休止的聊天交互。

核心组件

• skills/ – 实际的技能实现（例如：贝叶斯决策、博弈论策略、Web安全审计、WeRead阅读报告、教程撰写等）。
• registry/skills.json – 列出所有技能、公开状态和同步元数据的单一真实来源。
• docs/ – 设计文档、发布规则、命名规范和仓库级指南。
• scripts/ – 用于更新注册表、渲染 README 和 GitHub Pages 导航页的辅助脚本。
• index.html + assets/ – 从注册表生成的静态 HTML 目录，便于浏览。

精选技能

技能	功能	输出格式
Yao Crux	通过识别主要/次要矛盾诊断复杂问题，评估资源分配，并生成完整的决策报告。	Markdown、HTML、DOCX、PDF、JSON
Yao Bayesian	将不确定问题转化为贝叶斯决策工作流，支持先验/似然/后验更新，并生成可读报告。	Markdown、双语 HTML
Yao Websecurity	基于 275 项漏洞本体对网站、SaaS、API 或代码库进行审计，生成安全评分卡。	Excel、HTML、Markdown、PDF、清理后的 JSON
Yao WeRead	可视化用户 WeRead（微信读书）数据——阅读节奏、书架构成、笔记语义、词云等。	独立 HTML 报告
Yao Tutorial	将主题或源包转换为包含大纲、插图和多格式导出的完整初学者友好教程包。	Markdown、Word、PDF、HTML
Yao Game Theory	为价格战、谈判、平台竞争等生成战略博弈论报告，包含收益矩阵和可信度检查。	Markdown、HTML、Word、PDF、JSON

典型工作流

1. 提供本地技能目录。
2. 内置的 Yao Open Skills Sync 技能检查是否符合开源标准（无私有数据、成果干净、可复现）。
3. 若通过审核，技能将被复制到 skills/<slug>/，并在 registry/skills.json 中添加条目。
4. 运行 python3 scripts/render_collection_pages.py 以刷新 README 表格和 GitHub Pages HTML 目录。
5. 推送到 GitHub —— 技能现在可公开发现。

快速上手

# 克隆仓库
git clone https://github.com/yaojingang/yao-open-skills.git
cd yao-open-skills

# 安装任何 Python 依赖（脚本仅使用标准库）
# 探索一个技能，例如贝叶斯决策工作流
cd skills/yao-bayesian-skill
cat SKILL.md   # 入口点和使用说明
python3 scripts/generate_report_bundle.py  # 运行该技能

适合谁使用

• 需要可复现 AI 增强决策流程的研究人员和分析师。
• 寻找结构化、基于证据报告的产品或战略团队。
• 希望拥有可版本控制的模板化审计工作流的安全工程师。
• 希望自动化教程或阅读报告生成的内容创作者。
• 对将提示转化为可维护软件资产的 YAO 方法论感兴趣的任何人。

许可证 – 仓库遵循 docs/publishing-rules.md 中列出的开源发布规则；每个技能包含其自身的许可证信息（通常为 MIT 或 Apache-2.0），确保该集合可自由重用和扩展。

---

所有细节均直接取自仓库的 README 和链接文档；未添加任何外部假设。