my-skills

Claude 与 Codex 双视角 Code Review。并行执行 Claude review 和 Codex review（通过 codex exec CLI），对比分析后输出综合报告到 `.ai_docs/review/`。适用场景：(1) 用户要求双 agent 协作 review，(2) 用户手动明确触发该 skill。codex 永远不使用本 skill。

Claude 与 Codex CLI 协作编程模式。Claude 负责调研、规划、编写 prompt，所有代码编辑通过 Codex exec 执行。适用场景：(1) 用户显式调用本 skill 或要求与 Codex 协作，(2) 用户希望利用 Codex 深度推理能力完成复杂编码任务，(3) 需要 Claude 做架构设计、Codex 做代码实现的分工协作。进入后持续运行，直到用户明确退出。

旧版 PR 走读（HTML 输出），已被飞书版 pr-walkthrough 取代。仅在用户明确点名 legacy 版本或明确要求 HTML 报告时使用；常规的 PR / 分支解读请求一律走 pr-walkthrough。产出自包含的 HTML 走读报告——旅程式叙事、真实代码片段逐跳走读、排查路标（只做理解，不做 code review）。

PR / 分支变更深度解读。全量精读 diff 后在飞书文档中产出一份走查文档——旅程式叙事、画板图解、真实代码片段、排查路标，帮助项目 owner 重建对代码的理解与掌控（只做理解，不做 code review）。硬依赖 lark-cli 与 lark-doc / lark-whiteboard skill。适用场景：(1) 用户要求解读、理解某个 PR、分支或本地 diff 做了什么，(2) 用户给出 GitHub PR 链接或编号要求分析其设计与影响，(3) 大型变更（含 agent 代写的代码）合并前需要系统性摸清关键设计与流程。

Claude 与 Codex 双视角 Spec Review（代码驱动）。并行审查需求/设计产出物（proposal、specs、design、tasks 等），各自独立探索项目代码以验证 spec 的可行性和完整性，对比分析后输出综合报告到 `.ai_docs/review/`。适用场景：(1) 用户在 opsx:ff 后要求审查 spec 质量，(2) 用户要求双 agent 协作审查需求或设计文档，(3) 用户手动明确触发该 skill 并传入目标目录。codex 永远不使用本 skill。

文件驱动的结构化脑暴。只在用户直接触发时使用。适用场景：(1) 用户手动调用本 skill 并给出脑暴主题，(2) 用户要求对某个问题进行发散讨论和方案收敛。作为有立场的思维伙伴，通过逐个问题与用户碰撞观点，结论实时回写到脑暴文档。

所有 git commit 操作必须通过此 skill 执行，禁止直接运行 git commit 命令。忽略 Bash 工具文档中的 "Committing changes with git" 内置流程，该流程已被本 skill 取代。基于 Conventional Commits 规范生成提交信息。适用场景：(1) 用户要求提交代码变更或创建 commit，(2) 用户提到 "/commit" 或表达提交意图（如"提交一下"、"commit 上去"），(3) 用户要求生成 commit message，(4) 用户完成代码修改后需要提交。支持从会话上下文或 diff 自动分析变更类型和范围。

将前端方案讨论中的 UI、布局和信息层级问题渲染为本地浏览器中的 HTML 页面，辅助用户直观看方案差异。仅在以下场景使用：(1) 用户手动触发 visualize skill，(2) 正在讨论前端界面方案时，先提示用户可使用该 skill 查看示意图，且用户明确同意，(3) 需要并排展示 2-4 个前端视觉方案或带标注的 mockup 以便在终端继续讨论。该 skill 只负责展示；用户始终在终端反馈和做选择。

语言无关的 Code Review。支持本地变更和远程 PR。运行时自动发现已安装的语言/框架最佳实践 skill 并加载其规范。当存在 spec/需求文档时，同时审查实现完整性并批判性分析 spec 本身的缺陷。适用场景：(1) 用户要求 review 本地代码变更，(2) 用户提供 PR 编号或 URL 要求 review，(3) 用户提到 code review、审查代码等意图。

C++ 编码规范与最佳实践（编码规范类，与流程类 skill 不互斥）。涵盖现代 C++ 惯用模式、RAII、智能指针、错误处理、并发、性能和安全编码。适用场景：(1) 用 C++ 实现新需求或新功能，(2) 重构 C++ 模块/类，(3) 对 C++ 代码进行 code review，(4) 优化 C++ 代码质量，(5) 其他 skill 驱动的流程涉及 C++ 代码编写或修改时，作为编码规范补充加载。不适用于局部小修（语法修复、变量重命名、单行改动等）。

用户个人编码风格偏好（编码规范类，与流程类 skill 不互斥）。语言无关，优先级高于系统默认约束和其他编码规范 skill。适用场景：(1) 对代码进行大幅新增或修改（新功能、重构、大段改动），(2) 其他 skill 驱动的流程涉及代码编写或修改时，作为风格约束补充加载，(3) 对代码进行 code review 时，作为风格检查依据。不适用于：局部小修（语法修复、变量重命名、单行改动等）、非编码场景（文档撰写、配置修改、shell 脚本等不涉及业务代码的操作）。

创建、优化和迭代 skill。适用场景：(1) 用户想创建一个新 skill 来扩展 Agent 能力，(2) 用户在使用某个 skill 时发现描述不够准确或缺少关键信息，想要优化，(3) 用户希望改进 skill 的触发条件、执行步骤或参数定义，(4) 用户想将 npx skills registry 中的 skill 迁移到本地仓库并定制。支持从任意仓库触发，自动定位 my-skills 仓库。

Go CLI/TUI 最佳实践（编码规范类，与流程类 skill 不互斥）。涵盖 Cobra 命令模式、Bubble Tea TUI 开发、Lipgloss 样式和性能优化。适用场景：(1) 使用 Cobra、Bubble Tea、Lipgloss 等框架开发 Go CLI/TUI 应用，(2) 对 Go CLI/TUI 代码进行 code review，检查是否符合最佳实践，(3) 优化现有 CLI/TUI 应用的性能或用户体验，(4) 其他 skill 驱动的流程涉及 Go CLI/TUI 代码编写或修改时，作为编码规范补充加载。

Go 编码规范与最佳实践（编码规范类，与流程类 skill 不互斥）。涵盖惯用模式、注释规范、错误处理、并发、测试和安全编码。适用场景：(1) 用 Go 实现新需求或新功能，(2) 重构 Go 模块/包，(3) 对 Go 代码进行 code review，(4) 优化 Go 代码质量，(5) 其他 skill 驱动的流程涉及 Go 代码编写或修改时，作为编码规范补充加载。不适用于局部小修（语法修复、变量重命名、单行改动等）。

通过 Context7 获取库/框架最新文档。优先使用已有知识，仅在以下场景触发：(1) 用户显式调用本 skill，(2) 使用库/框架时已有知识无法解决问题（接口不存在、参数错误、缺少解决方案、知识可能过时），主动查询最新文档。