myskills — 个人 Claude Code 技能合集

项目概述

myskills 是我个人的 Claude Code 自定义技能合集仓库，将 AI 协作中的重复性工作流程和操作规范编码为可复用的结构化技能。每个技能本质上是一份精心设计的 SKILL.md 文件，定义特定场景下的 AI 行为规范——什么时候激活、按什么流程执行、输出什么格式。

技能列表

📋 workflow-recorder — 工作流程记录器

在 Claude Code 会话中系统性地记录工作过程。追踪操作步骤、关键决策和问题解决方案，会话结束时生成结构化报告。

四阶段工作流：开始记录 → 持续记录 → 手动补充 → 生成报告

三大追踪维度：工作流程（操作步骤 + 结果）、关键决策（候选方案 + 选择理由）、问题与解决方案（错误原文 + 排查过程 + 最终方案）

🔧 github-project-maintenance — GitHub 项目维护

规范 GitHub 项目的修改流程，区分对自己项目（直接在 main 修改）和他人项目（分支 → rebase → 冲突解决 → PR）两大类场景。包含完整的提交规范、分支命名策略和异常处理流程。

设计理念

按功能类型分组的目录结构

myskills/
├── recording/          ← "记录与追踪"类
│   └── workflow-recorder/
├── maintenance/        ← "维护与管理"类
│   └── github-project-maintenance/
└── reports/            ← workflow-recorder 生成的报告存档

选择功能类型而非使用频率或技术栈作为分类维度，因为它稳定且符合"找技能"的心智模型。

决策树驱动的流程设计

每个技能内部使用明确的决策树而非模糊描述，让 AI 有清晰的判断路径：

需要修改 GitHub 项目
├── 这是我自己的项目？
│   └── 是 → 直接在 main 修改 → 按规范提交 → push
└── 这是别人的项目？
    └── 是 → 判断修改类型 → 创建分支 → 修改提交 → 检查远程 → rebase → PR

异常场景覆盖

每个分支都设计了失败退出路径。以 github-project-maintenance 的 rebase 冲突为例，提供了四种策略：自动解决、询问用户、--abort 放弃、改用 merge。没有退出路径的流程遇到问题就会卡死。

技术细节

• 格式标准：所有技能使用 YAML frontmatter（name + description + origin）+ Markdown 正文的结构
• 模板驱动：workflow-recorder 附带 templates/report-template.md，确保每次输出格式一致
• 自举验证：用 workflow-recorder 记录 myskills 自身的开发过程，生成的报告存档在 reports/ 目录
• 安装方式：复制技能目录到 ~/.claude/skills/，即可通过 /skill-name 调用

持续维护计划

此仓库作为个人基础设施持续维护，迭代方向：

• 在实际开源项目中验证 github-project-maintenance 的流程 B（对他人项目修改）
• 根据使用反馈持续迭代现有技能
• 探索新的技能类型（开发辅助、代码审查、文档生成等）
• 建立技能之间的引用网络（如 workflow-recorder 与其他技能的协作）