القائمة
复盘 Speculo commands/workflows 使用过程中的痛点、问题与值得优化的地方，深度分析后产出去重、分级、根因化、可直接转成 GitHub issue 的规范化改进提案；当用户要求总结 Speculo 使用体验、收集框架反馈或把使用痛点整理成 issue 时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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 的交接字段时读取。