本项目的目标是将 https://github.com/codecrafters-io/build-your-own-x 中的项目逐步转换为 skills，让每个开发者都能通过 AI 技术，快速学习各种工程实践技能。

总入口 技能（新增）

仓库根目录现在本身就是一个 skill：build-your-own-x。根目录的 SKILL.md 是路由入口，帮开发者选主题、语言和教程，再交给 skills/ 下的子 skill。子 技能 分两类：

• 主线 技能（每个分类一个导师 skill，6–7 个里程碑，每步都有可运行的检查点）：上游全部 31 个分类均已完成，位于 skills/ /，例如 git、database、operating-system、ai-model。
• 单教程 技能（skills/ - ）：每个对应上游的一篇教程。

各分类状态与上游链接见 references/catalog.md。Skill 以带教为主：概念 → 骨架 → 学习者写代码 → 测试，不直接给完整答案。

安装：npx skills add linkxzhou/build-your-own-x-skills，或克隆仓库后运行 ./init.sh。

评测：见 benchmarks/REPORT.md（quick_validate、链接核对、31 个主线 skill 的冒烟测试、路由触发测试）。

致谢：主题与链接来自 codecrafters-io/build-your-own-x（CC0 1.0），详见 ATTRIBUTION.md。

当前状态

• 上游 build-your-own-x（2026-10-19 快照）：31 个分类、359 个教程链接
• 主线 技能（按分类）：31
• 单教程 技能：357（原 351 个 + 新增 4 个分类的 6 个）
• 已生成 examples：351（新增 6 个单教程 技能 暂无 example）
• 总入口：根目录 SKILL.md
• 转换计划：plan/
• 技能清单：skills/x-skills-manifest.json
• 示例清单：examples/examples-manifest.json

说明：此前生成过带 8 位哈希后缀的临时 skill，因名称可读性差已删除;当前 README 中勾选的条目对应保留在 skills/ 中的可用 skill。

目录结构

安装

1. 克隆项目到本地。
2. 运行 ./init.sh，将 skills/ 软链到各 AI 编程工具的技能目录。

背景

本项目的目标是将 https://github.com/codecrafters-io/build-your-own-x 中的项目逐步转换为 skills，让每个开发者都能通过 AI 技术，快速学习各种工程实践技能。

总入口 skill（新增）

仓库根目录现在本身就是一个 skill：build-your-own-x。根目录的 SKILL.md 是路由入口，帮开发者选主题、语言和教程，再交给 skills/ 下的子 skill。子 skill 分两类：

• 主线 skill（每个分类一个导师 skill，6–7 个里程碑，每步都有可运行的检查点）：上游全部 31 个分类均已完成，位于 skills//，例如 git、database、operating-system、ai-model。
• 单教程 skill（skills/-）：每个对应上游的一篇教程。

各分类状态与上游链接见 references/catalog.md。skill 以带教为主：概念 → 骨架 → 学习者写代码 → 测试，不直接给完整答案。

安装：npx skills add linkxzhou/build-your-own-x-skills，或克隆仓库后运行 ./init.sh。

评测：见 benchmarks/REPORT.md（quick_validate、链接核对、31 个主线 skill 的冒烟测试、路由触发测试）。

致谢：主题与链接来自 codecrafters-io/build-your-own-x（CC0 1.0），详见 ATTRIBUTION.md。

当前状态

• 上游 build-your-own-x（2026-10-19 快照）：31 个分类、359 个教程链接
• 主线 skill（按分类）：31
• 单教程 skill：357（原 351 个 + 新增 4 个分类的 6 个）
• 已生成 examples：351（新增 6 个单教程 skill 暂无 example）
• 总入口：根目录 SKILL.md
• 转换计划：plan/
• skill 清单：skills/x-skills-manifest.json
• example 清单：examples/examples-manifest.json

说明：此前生成过带 8 位哈希后缀的临时 skill，因名称可读性差已删除；当前 README 中勾选的条目对应保留在 skills/ 中的可用 skill。

目录结构

build-your-own-x-skills/
├── .claude/skills/          # Claude Code skills 目录，软链到 skills/
├── .codebuddy/skills/       # CodeBuddy skills 目录，软链到 skills/
├── .trae/skills/            # TRAE skills 目录，软链到 skills/
├── .gemini/skills/          # Gemini CLI skills 目录，软链到 skills/
├── skills/                  # skills 主目录，每个子目录是一个 skill
├── plan/                    # build-your-own-x 到 skill 的转换计划
├── examples/                # 按大类型组织的 skill 使用示例
├── tests/                   # 技能测试
├── README.md                # 中文说明
├── README_EN.md             # 英文说明
├── README_PROMPT.md         # Prompt 模板与测试提示词
└── init.sh                  # 初始化软链脚本

安装

1. 克隆项目到本地。
2. 运行 ./init.sh，将 skills/ 软链到各 AI 编程工具的技能目录。
3. 在支持 skills 的工具中使用 [使用Skills: skill-name] 或自动触发。

使用示例

每个可用 skill 都有一个对应 example，按大类型组织：