yun-skills

这个仓库收集了一组可复用的 Codex skills，用来把常见工作流沉淀成稳定、可复用的操作指南。

每个 skill 都是一个独立目录，核心文件为 SKILL.md，可选的 agents/openai.yaml 用于定义在 OpenAI/Codex 环境中的展示名称、简短说明和默认提示词。

Skills

Skill	用途	适合场景
competitor-conversion-audit	从竞品高频用户的视角审查项目源码，找出影响迁移、留存和信任的产品改进机会。	想分析一个产品为什么不能吸引竞品用户迁移；想基于代码找出产品缺口、留存风险、核心流程问题。
conversation-skill-gap-analyzer	分析已有对话历史，识别重复任务、未满足需求和可沉淀为 skill 的机会。	想复盘最近的工作模式；想规划 3-5 个高价值自定义 skill；想把反复出现的协作需求变成可复用流程。

Repository Structure

yun-skills/
├── README.md
├── competitor-conversion-audit/
│   ├── SKILL.md
│   └── agents/
│       └── openai.yaml
└── conversation-skill-gap-analyzer/
    ├── SKILL.md
    └── agents/
        └── openai.yaml

How To Use

把需要的 skill 目录复制到本机 Codex skills 目录：

Copy-Item -Recurse .\competitor-conversion-audit $env:USERPROFILE\.codex\skills\
Copy-Item -Recurse .\conversation-skill-gap-analyzer $env:USERPROFILE\.codex\skills\

也可以克隆仓库后按需同步：

git clone https://github.com/Britneycode/yun-skills.git

在 Codex 对话中可以直接点名使用：

Use $competitor-conversion-audit to analyze this project.
Use $conversation-skill-gap-analyzer to review our recent work and recommend reusable skills.

Skill Details

competitor-conversion-audit

这个 skill 会先从项目源码中识别产品类别、核心用户角色、主要工作流、数据对象、API、页面和测试信号，再从“竞品忠实用户是否愿意迁移并留下”的角度输出产品改进建议。

它强调：

• 建议必须有源码证据，例如路由、组件、API、模型、测试、TODO 或缺失流程。
• 区分已确认问题和推断机会。
• 按 P0、P1、P2 标注优先级。
• 优先关注迁移、激活、核心流程、信任、留存，而不是泛泛的视觉优化。

conversation-skill-gap-analyzer

这个 skill 会从可见对话历史中提取反复出现的任务模式、工具偏好、质量要求和协作摩擦，并将它们转化为可执行的 skill 建议。

它强调：

• 明确说明证据来源和上下文限制。
• 推荐 3-5 个可行动的 skill 方向。
• 设计 2-3 个更贴合用户上下文的自定义 skill 规格。
• 按频率、杠杆、具体性、验证价值和风格契合度排序。

Adding A New Skill

新增 skill 时建议保持这个结构：

skill-name/
├── SKILL.md
└── agents/
    └── openai.yaml

SKILL.md 建议包含：

• YAML front matter：name 和 description
• skill 的目标和触发场景
• 具体工作流
• 输出格式
• 质量标准或 guardrails

agents/openai.yaml 建议包含：

interface:
  display_name: "Readable Skill Name"
  short_description: "One-line summary"
  default_prompt: "Use $skill-name to ..."

Maintenance

更新 skill 后，建议检查三件事：

1. SKILL.md 的 name 是否与目录名一致。
2. description 是否清楚说明何时应该触发。
3. agents/openai.yaml 的默认提示词是否能直接复制到对话中使用。