Menú
复盘 Speculo commands/workflows 使用过程中的痛点、问题与值得优化的地方，深度分析后产出去重、分级、根因化、可直接转成 GitHub issue 的规范化改进提案；当用户要求总结 Speculo 使用体验、收集框架反馈或把使用痛点整理成 issue 时使用。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
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" 时使用。
| id | speculo-retro |
| type | skill |
| name | Speculo Retro |
| description | 复盘 Speculo commands/workflows 使用过程中的痛点、问题与值得优化的地方，深度分析后产出去重、分级、根因化、可直接转成 GitHub issue 的规范化改进提案；当用户要求总结 Speculo 使用体验、收集框架反馈或把使用痛点整理成 issue 时使用。 |
当用户想复盘「用 Speculo 的 commands 或 workflows 时遇到的痛点、问题、值得优化的地方」，并希望把这些摩擦整理成规范化、可行动的框架反馈或 issue 时使用。
典型触发：
本 skill 只负责分析与规范化产出内容：它去重、分级、根因化并起草 issue-ready 提案，把结果返回给调用方。它不自行写文件、不调用 gh、不发布 issue；落盘与提交由调用方 command / workflow 负责。
speculo/.speculo/commands/<run>/ 下的历史命令产物（report、snapshot、handoff）speculo/.speculo/<cat>/<change>/ 下的 change 产物与 .status.json（phase_history 里的 revisited、blocked、长时间停滞都是摩擦信号）speculo/.speculo/.config/LESSONS.md（已沉淀的教训，用于去重与佐证）references/，分析时不外读仓库 docs/LESSONS.md 而非提 issue）speculo/.speculo/... 路径；本 skill 不挑选持久化位置references/friction-taxonomy.md 的来源清单，扫描对话上下文、speculo/.speculo/ 产物与 LESSONS.md，列出原始摩擦点。references/friction-taxonomy.md 的优先级评分。references/issue-drafting-sop.md 把每条规范化成 issue-ready 提案，并对照调用方提供的已存在 issue 做跨提案去重。gh。references/friction-taxonomy.md：确定信号来源、给摩擦点归类、按影响 × 频率评优先级、过滤噪声时读取。references/issue-drafting-sop.md：把改进提案规范化成 issue-ready 结构、对照已存在 issue 去重、生成给调用方 / gh 的交接字段时读取。