learning-open-code

Manage git submodules for the learning-open-code mono-repo. Use when the user wants to: (1) Add a new git submodule — auto-detect or specify the category (open-ai-skills/open-sdd/open-ai-agent/open-ai-desktop/open-knowledge/open-productivity/open-java/open-trading/open-data), record the tracking branch in .gitmodules, clone the repo, and update README.md index. (2) Sync all existing submodules to their configured branches (git fetch + checkout branch + pull). (3) Update the root README.md with an up-to-date index of all synced projects grouped by category. (4) Initialize submodules after git clone — when open-*/ directories are empty or git submodule status returns nothing, guide through the full SOP (git submodule update --init --recursive [--remote]). Trigger keywords: submodule, git submodule, 子模块, add submodule, sync submodule, update submodule, submodule branch, README index, 更新索引, clone, init, 初始化子模块, submodule init, 拉取子模块.

对开源项目进行穷尽式教学文档生成——从宏观架构到微观实现的五层分级讲解，使用 Goal Loop 算法自主驱动完整代码覆盖。所有具体教学内容生成必须激活 `.agents/skills/teach/SKILL.md`。触发条件：用户要求"完整学习某个项目"、"生成项目架构文档"、"从入口到落地讲清楚每个功能"、"代码考古"、"源码分析"、或指定一个项目目录/仓库要求全面教学。

使用并行子 agent 为模块生成多个截然不同的接口设计。当用户想要设计 API、探索接口选项、比较模块形态，或提到 "设计两次" 时使用。

交互式 QA 会话，用户以对话方式报告 bug 或问题，agent 将其录入 GitHub Issue。在后台探索代码库以获取上下文和领域语言。当用户想要报告 bug、做 QA、以对话方式录入 issue，或提及 "QA session" 时使用。

通过用户访谈创建包含微小提交的详细重构计划，并将其录入 GitHub Issue。当用户想要规划重构、创建重构 RFC，或将重构分解为安全的渐进步骤时使用。

从当前对话中提取 DDD 风格的通用语言词汇表，标记歧义并提出规范术语。保存到 UBIQUITOUS_LANGUAGE.md。当用户想要定义领域术语、构建词汇表、固化术语、创建通用语言，或提到 "领域模型" 或 "DDD" 时使用。

将当前对话交接给一个新的后台代理，由它立即接手继续工作。

在此工作区内，反复追问我想要构建的工作流规格。

生成一个交互式 bash 向导，引导人工用户完成一个手动流程——第三方设置、一次性迁移、A→B 状态转换——打开 URL、捕获值、确认每一步，并写入 .env 文件和 GitHub Actions secrets。

写作，利用阶段——将原始素材组装成一段节拍旅程，在每个节拍依赖某个术语之前先将其落地。

写作，探索阶段——挖掘原始碎片，尚无结构。

写作，利用阶段——将原始素材塑造成一篇文章，逐段推进。

设置 Claude Code hooks 来在执行前拦截并阻止危险的 git 命令（push、reset --hard、clean、branch -D 等）。当用户想要防止破坏性 git 操作、添加 git 安全钩子、或在 Claude Code 中阻止 git push/reset 时使用。

将测试文件中的 `as` 类型断言迁移到 @total-typescript/shoehorn。当用户提到 shoehorn、想要在测试中替换 `as`、或需要部分测试数据时使用。

创建包含章节、问题、解答和讲解的练习目录结构，并通过 lint 检查。当用户想要搭建练习脚手架、创建练习桩代码、或设置新的课程章节时使用。

在当前仓库中设置 Husky pre-commit hooks，包含 lint-staged（Prettier）、类型检查和测试。当用户想要添加 pre-commit hooks、设置 Husky、配置 lint-staged、或添加提交时的格式化/类型检查/测试时使用。

通过重组章节、提高清晰度和精炼文笔来编辑和改进文章。当用户想要编辑、修订或改进文章草稿时使用。

使用 wikilinks 和索引笔记在 Obsidian 仓库中搜索、创建和管理笔记。当用户想要在 Obsidian 中查找、创建或组织笔记时使用。

在此工作区内教授用户一项新技能或概念。

在本工作区内教用户学习新技能或新概念。适用于用户想要学习某个主题、请求教学指导的场景。

为任意项目扫描 manifest 目录、判定角色、收集证据并生成极简 AGENTS.md 与 CLAUDE.md 重定向文件，形成完整父子导航树；当用户要求为项目生成/刷新 AGENTS.md、构建模块文档导航树、初始化 AI 代理可读的项目导读文档时使用。

启用或关闭超压缩沟通模式以降低 token 消耗；当用户要求 caveman mode、少 token、极简技术表达，或调用 command/caveman 时使用。

dry-run 审计 .config 中可安全删除或合并的过期知识资产，生成分组候选清单；当用户要求清理 .config、prune config、审计知识资产过期项、或通过 command/config-prune 调用时使用。

GitHub 仓库运营与 npm 发布原子能力；用于 issue/PR/CI/security 治理、release.yml 配置、npm provenance 发布、tag 发版、三端验证和失败恢复。

对计划、设计或决策进行逐问式压力测试；当用户要求 grill me、拷问方案、压力测试计划，或调用 command/grill-me 时使用。

将当前对话压缩成脱敏交接正文与元数据；当用户需要另一个 agent、另一个会话或 command/handoff 接手继续工作时使用。

创建课程章节与练习目录骨架并验证 lint；当用户要求 scaffold exercises、创建练习桩、设置课程章节，或调用 command/scaffold-exercises 时使用。

复盘 Speculo commands/workflows 使用过程中的痛点、问题与值得优化的地方，深度分析后产出去重、分级、根因化、可直接转成 GitHub issue 的规范化改进提案；当用户要求总结 Speculo 使用体验、收集框架反馈或把使用痛点整理成 issue 时使用。

创建或改造 Speculo workflows、skills、commands 的原子能力；当用户要求根据参考项目、外部技能、当前规范或产品意图，设计、迁移、融合、更新 Speculo 资产时使用。

在独立 git worktree 中隔离推进一个 change 的原子能力；当 dev workflow 需要为某个 change 建立隔离分支与 .worktree/ 工作树、审查整条 change 分支树的全部 commit、或在收尾时把分支合并回原分支并清理时使用。默认不启用，仅在用户显式请求隔离时由调用方读取。

设计深层模块的共享词汇。适用于用户想要设计或改进模块接口、寻找深化机会、决定接缝位置、使代码更可测试或对 AI 更可导航，或其他技能需要深层模块词汇的场景。

Create, analyze, proofread, and modify Office documents (.docx, .xlsx, .pptx) using the officecli CLI tool. Use when the user wants to create, inspect, check formatting, find issues, add charts, or modify Office documents.

适用于需要解决进行中的 git merge/rebase 冲突的场景。

将英文技术文档仓库（插件市场、SKILL.md、command.md、README、JSON 清单、Python 验证脚本、纯 Markdown 技能集合等）全面翻译为中文的系统化流程。严格遵循中文文档排版规范（中英空格、全半角标点、术语保留、自然中文表达）。支持状态追踪和增量翻译——源文件更新后仅翻译变更部分。适用于包含 frontmatter 的 markdown 文件、插件清单、命令定义、技能集合。触发词：翻译成中文、中文本地化、translate to Chinese、中文文档、documentation translation、更新翻译、增量翻译。

指导稳定的 API 和接口设计。适用于设计 API、模块边界或任何公共接口，创建 REST 或 GraphQL 端点，定义模块间的类型契约，或建立前后端之间的边界。

通过 Chrome DevTools MCP 在真实浏览器中测试。适用于构建或调试任何在浏览器中运行的内容。适用于需要检查 DOM、捕获控制台错误、分析网络请求、分析性能或使用真实运行时数据验证视觉输出。需要配置 chrome-devtools MCP 服务器。

自动化 CI/CD 流水线设置。适用于搭建或修改构建和部署流水线，自动化质量门禁，在 CI 中配置测试运行器，或建立部署策略。

进行多维度代码评审。适用于合并任何变更之前。适用于评审由你自己、另一个 agent 或人类编写的代码。适用于在代码进入主分支之前，需要跨多个维度评估代码质量的场景。

简化代码以提高清晰度。适用于在不改变行为的前提下重构代码以提高可读性时。当代码可以运行、但阅读、维护或扩展起来比应有的难度更高时使用。当审查已积累不必要复杂度的代码时使用。

优化 agent 上下文设置。适用于开始新会话、agent 输出质量下降、任务切换，或需要为项目配置规则文件和上下文时使用。