@namewta/speculo 0.1.20 → 0.2.0

package/template/commands/caveman.md

@@ -1,50 +0,0 @@
----
-id: caveman
-type: command
-name: Caveman Mode
-description: 启用或关闭超压缩沟通模式
-keywords: [caveman, brief, tokens, 简洁]
----
-
-# Caveman 命令
-
-## 归档路径模式
-
-可选产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-caveman-<topic>/`
-
-模式报告：`speculo/.speculo/commands/<YYYY-MM-DD>-caveman-<topic>/mode.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从用户请求提取，使用小写 kebab-case；无法判断时使用 `mode`。
-- 禁止把模式报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-（通常只改变对话风格，不需要持久化。）
-
-## 调用的 skills
-
-- `../skills/caveman/SKILL.md` — 用户要求启用、关闭或检查 caveman mode 时读取。
-
-## 执行步骤
-
-1. 读取 `../skills/caveman/SKILL.md`。
-2. 根据用户意图启用或关闭压缩沟通模式。
-3. 若用户只要求启用模式，在对话中确认当前模式即可，不写文件。
-4. 若用户要求记录模式切换，把报告写入 `speculo/.speculo/commands/<YYYY-MM-DD>-caveman-<topic>/mode.md`。
-
-## 产物模板（mode.md，可选）
-
-> **服务命令：** `caveman.md`
-> **产物文件名：** `mode.md`
-
-```markdown
-# Caveman Mode
-
-## 时间
-[TODO: ISO 8601 时间戳。]
-
-## 动作
-[TODO: 记录启用、关闭或检查模式。]
-
-## 用户原始请求
-[TODO: 记录触发命令的用户请求摘要。]
-```

package/template/commands/config-prune.md

@@ -1,59 +0,0 @@
----
-id: config-prune
-type: command
-name: Config Prune
-description: dry-run 审计 .config 中可安全删除或合并的过期知识资产
-keywords: [config-prune, config, adr, context, lessons, rules, prune, 清理]
----
-
-# Config Prune 命令
-
-⚠️ **默认 dry-run。** 本命令涉及 `.config` 知识资产删除或合并，AI 必须先列出候选清单并征求用户确认。没有确认时只写报告，不删除、不重命名、不改 RULES。
-
-## 归档路径模式
-
-产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-config-prune-<topic>/`
-
-报告文件：`speculo/.speculo/commands/<YYYY-MM-DD>-config-prune-<topic>/report.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从清理范围或用户主题提取，使用小写 kebab-case；无法判断时使用 `config`。
-- 禁止把报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-## 调用的 skills
-
-- `../skills/config-prune/SKILL.md` — dry-run 审计 .config 知识资产过期项、生成分组候选清单时读取。
-
-## 执行步骤
-
-1. 读取 `../skills/config-prune/SKILL.md`，按其执行步骤与边界执行 config-prune 审计。
-2. 创建规范命令产物目录 `speculo/.speculo/commands/<YYYY-MM-DD>-config-prune-<topic>/`。
-3. 把 skill 返回的候选清单、证据、风险、用户确认记录和执行结果写入 `report.md`（使用下方产物模板）。
-4. 返回 `report.md` 路径和 3-5 条摘要。
-
-## 产物模板（report.md）
-
-> **服务命令：** `config-prune.md`
-> **产物文件名：** `report.md`
-
-```markdown
-# Config Prune Report
-
-## 执行时间
-[TODO: ISO 时间戳]
-
-## 模式
-[TODO: dry-run / confirmed]
-
-## 扫描范围
-[TODO: 列出读取的 .config 路径、引用扫描命令和排除目录]
-
-## 候选清单
-[TODO: 按 delete / merge / rewrite / keep / needs-confirmation 分组列出候选、证据和风险]
-
-## 用户确认记录
-[TODO: dry-run 时写无确认；执行时记录用户确认的原始要点]
-
-## 执行结果
-[TODO: 成功 / 失败 / 部分成功；列出实际改动和跳过项]
-```

package/template/commands/grill-me.md

@@ -1,48 +0,0 @@
----
-id: grill-me
-type: command
-name: Grill Me
-description: 对计划或设计进行逐问式压力测试
-keywords: [grill, 追问, pressure-test, 方案]
----
-
-# Grill Me 命令
-
-## 归档路径模式
-
-可选产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/`
-
-报告文件：`speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/report.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从被压力测试的计划或决策主题提取，使用小写 kebab-case；无法判断时使用 `decision`。
-- 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-## 调用的 skills
-
-- `../skills/grill-me/SKILL.md` — 用户要求拷问计划、设计或决策时读取。
-
-## 执行步骤
-
-1. 读取 `../skills/grill-me/SKILL.md`。
-2. 先探索可从仓库确认的事实。
-3. 对无法从仓库确认且会改变决策树的问题，每次只问一个。
-4. 用户要求持久化时，把已确认决策和开放问题写入 `speculo/.speculo/commands/<YYYY-MM-DD>-grill-me-<topic>/report.md`。
-
-## 产物模板（report.md，可选）
-
-> **服务命令：** `grill-me.md`
-> **产物文件名：** `report.md`
-
-```markdown
-# Grill Me Report
-
-## 主题
-[TODO: 记录被压力测试的计划或设计。]
-
-## 已确认决策
-[TODO: 列出已确认决策和用户确认依据。]
-
-## 开放问题
-[TODO: 列出仍未解决的问题、推荐答案和阻塞原因。]
-```

package/template/commands/handoff.md

@@ -1,59 +0,0 @@
----
-id: handoff
-type: command
-name: Handoff
-description: 生成脱敏交接文档，供另一个 agent 或会话接手
-keywords: [handoff, 交接, summary, resume]
----
-
-# Handoff 命令
-
-## 归档路径模式
-
-产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/`
-
-交接文件：`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从用户目标或交接主题提取，使用小写 kebab-case；无法判断时使用 `session`。
-- 禁止把交接文档写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-## 调用的 skills
-
-- `../skills/handoff/SKILL.md` — 需要把当前对话压缩成交接文档时读取。
-
-## 执行步骤
-
-1. 读取 `../skills/handoff/SKILL.md`。
-2. 按 `../skills/handoff/SKILL.md` 要求，生成脱敏交接文档。
-3. 创建规范命令产物目录 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/`。
-4. 把交接正文写入 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`。
-5. 删除 API key、密码、PII 和其他敏感信息；不要复制 PRD、计划、ADR、issue、commit、diff 或其他已有产物正文。
-6. 返回 `handoff.md` 路径、3-5 条摘要和推荐技能清单。
-
-## 产物模板（handoff.md）
-
-> **服务命令：** `handoff.md`
-> **产物文件名：** `handoff.md`
-
-```markdown
-# Handoff
-
-## 目标
-[TODO: 概括当前任务目标和用户下一步重点。]
-
-## 已完成
-[TODO: 列出已完成工作、关键决策和重要文件路径。]
-
-## 未完成
-[TODO: 列出下一步、阻塞点和剩余风险。]
-
-## 验证
-[TODO: 记录已运行命令、结果和未运行原因。]
-
-## 推荐技能
-[TODO: 列出下一个 agent 推荐读取的 skill。]
-
-## 摘要
-[TODO: 用 3-5 条概括交接内容，不复制敏感信息。]
-```

package/template/commands/scaffold-exercises.md

@@ -1,56 +0,0 @@
----
-id: scaffold-exercises
-type: command
-name: Scaffold Exercises
-description: 创建课程练习目录骨架并运行练习 lint
-keywords: [exercises, scaffold, course, lint, 练习]
----
-
-# Scaffold Exercises 命令
-
-⚠️ **本命令会创建或移动项目文件，且 source skill 可能执行 git commit。AI 必须先列出影响清单并征求用户确认才能执行。**
-
-## 归档路径模式
-
-产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/`
-
-报告文件：`speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/report.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从章节、练习或课程主题提取，使用小写 kebab-case；无法判断时使用 `exercises`。
-- 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-## 调用的 skills
-
-- `../skills/scaffold-exercises/SKILL.md` — 用户要求创建课程章节或练习桩时读取。
-
-## 执行步骤
-
-1. 读取 `../skills/scaffold-exercises/SKILL.md`。
-2. 解析章节、练习、编号、名称、变体类型和目标路径。
-3. 列出将创建、移动或提交的路径，以及将运行的 lint / git 命令。
-4. 等待用户明确确认；没有确认时只输出计划，不创建目录、不提交 git。
-5. 用户确认后执行创建、lint 和修复循环。
-6. 只有用户明确要求时才执行 git commit。
-7. 写入 `speculo/.speculo/commands/<YYYY-MM-DD>-scaffold-exercises-<topic>/report.md`。
-
-## 产物模板（report.md）
-
-> **服务命令：** `scaffold-exercises.md`
-> **产物文件名：** `report.md`
-
-```markdown
-# Scaffold Exercises Report
-
-## 影响清单
-[TODO: 列出将创建或移动的章节、练习和变体路径。]
-
-## 用户确认
-[TODO: 记录用户确认执行的原始内容摘要。]
-
-## 执行结果
-[TODO: 记录目录创建、lint、修复和可选 git commit 结果。]
-
-## 后续事项
-[TODO: 列出仍需补充内容、失败 lint 或阻塞原因。]
-```

package/template/commands/write-a-skill.md

@@ -1,52 +0,0 @@
----
-id: write-a-skill
-type: command
-name: Write A Skill
-description: 创建或审查新的 Speculo skill 草稿
-keywords: [skill, create, write, 技能]
----
-
-# Write A Skill 命令
-
-## 归档路径模式
-
-产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/`
-
-报告文件：`speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/report.md`
-
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从 skill 名称或用户主题提取，使用小写 kebab-case；无法判断时使用 `skill`。
-- 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
-
-## 调用的 skills
-
-- `../skills/speculo-write/SKILL.md` — 用户要求创建、审查或改进可复用 skill 时读取；该 skill 自带 skill authoring 规范。
-
-## 执行步骤
-
-1. 读取 `../skills/speculo-write/SKILL.md`，并按其 `references/skill-authoring-sop.md` 内化 skill 规范。
-2. 先收集技能用途、触发条件、输入输出、脚本需求和示例需求。
-3. 写文件前列出将创建或修改的路径，并等待用户明确确认。
-4. 用户确认后，按 Speculo 契约创建 `../skills/<name>/SKILL.md` 及可选 `references/`、`scripts/`、`examples/`。
-5. 把设计摘要、影响路径和验证结果写入 `speculo/.speculo/commands/<YYYY-MM-DD>-write-a-skill-<topic>/report.md`。
-
-## 产物模板（report.md）
-
-> **服务命令：** `write-a-skill.md`
-> **产物文件名：** `report.md`
-
-```markdown
-# Write A Skill Report
-
-## 技能目标
-[TODO: 描述新 skill 的任务、触发条件和使用者。]
-
-## 影响路径
-[TODO: 列出本次创建或修改的路径。]
-
-## 用户确认
-[TODO: 记录用户确认创建或修改文件的原始内容摘要。]
-
-## 验证结果
-[TODO: 记录 frontmatter、自包含性、渐进披露和脚本检查结果。]
-```

package/template/skills/caveman/SKILL.md

@@ -1,38 +0,0 @@
----
-id: caveman
-type: skill
-name: Caveman
-description: 启用或关闭超压缩沟通模式以降低 token 消耗；当用户要求 caveman mode、少 token、极简技术表达，或调用 command/caveman 时使用。
----
-
-# Caveman
-
-## 何时使用
-
-当用户要求 `caveman mode`、`talk like caveman`、`use caveman`、少 token、极简表达、`be brief`，或调用对应 command 时使用。
-
-当用户要求 `stop caveman`、`normal mode` 或明确恢复正常表达时关闭。
-
-## 输入
-
-- 用户对沟通模式的启用、关闭或保持要求
-- 当前对话中的技术事实、风险和下一步动作
-- 需要原样保留的代码、命令、错误信息或用户引用
-
-## 输出
-
-- 保留技术准确性的压缩回复风格
-- 必要时对安全风险、不可逆操作或多步骤顺序使用完整清晰表达
-- 不产生 `speculo/.speculo/` 或 `.status.json` 持久化产物
-
-## 执行步骤
-
-1. 判定用户是在启用、关闭还是检查 caveman mode。
-2. 启用后跨轮保持，直到用户明确关闭。
-3. 使用 `references/compression-rules.md` 的压缩规则、例外和示例。
-4. 原样保留代码块、命令、错误信息和需要精确引用的文本。
-5. 遇到安全警告、不可逆操作确认、易误读的多步骤序列或用户反复澄清时，暂时退出压缩表达；清晰部分结束后恢复。
-
-## 渐进披露
-
-- `references/compression-rules.md`：启用 caveman mode 或判断何时暂时退出压缩表达时读取。

package/template/skills/caveman/references/compression-rules.md

@@ -1,102 +0,0 @@
-# Caveman Compression Rules
-
-## 持久性
-
-一旦触发，每次回复都保持激活。多轮对话后不回退，不漂移回普通表达。
-
-如果不确定是否仍激活，就继续保持。只有当用户说 `stop caveman`、`normal mode` 或等价指令时才关闭。
-
-## 压缩规则
-
-去除：
-
-- 冠词和不影响含义的连接词
-- 填充词，如 just、really、basically、actually、simply
-- 客套话，如 sure、certainly、of course、happy to
-- 模糊化表达和不必要的铺垫
-
-优先使用：
-
-- 句子片段
-- 短同义词，例如用 `big` 而不是 `extensive`
-- 常见技术缩写，例如 DB、auth、config、req、res、fn、impl
-- 箭头表示因果关系，例如 `X -> Y`
-- 一个词能说清时不用两个词
-
-保持精确：
-
-- 技术术语不降级
-- 代码块不改写
-- 错误信息原样引用
-- 不为了短而省略关键前提、风险或边界
-
-## 输出模式
-
-默认句式：
-
-```text
-[东西] [动作] [原因]。[下一步]。
-```
-
-不要：
-
-```text
-Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by...
-```
-
-要：
-
-```text
-Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:
-```
-
-## 示例
-
-用户问：为什么 React 组件重新渲染？
-
-回答：
-
-```text
-内联对象属性 -> 新引用 -> 重新渲染。用 `useMemo`。
-```
-
-用户问：解释数据库连接池。
-
-回答：
-
-```text
-连接池 = 复用数据库连接。跳过握手 -> 高负载下更快。
-```
-
-## 自动清晰度例外
-
-遇到以下情况暂时退出 caveman mode：
-
-- 安全警告
-- 不可逆操作的确认
-- 片段顺序可能导致误读的多步骤序列
-- 用户要求澄清或重复提问
-
-清晰部分完成后恢复 caveman mode。
-
-示例：
-
-```md
-**警告：** 这将永久删除 `users` 表中的所有行，且无法撤销。
-
-    DROP TABLE users;
-
-恢复 caveman mode。先确认备份存在。
-```
-
-也可以在实际回复中使用 SQL fence：
-
-````md
-**警告：** 这将永久删除 `users` 表中的所有行，且无法撤销。
-
-```sql
-DROP TABLE users;
-```
-
-恢复 caveman mode。先确认备份存在。
-````

package/template/skills/config-prune/SKILL.md

@@ -1,66 +0,0 @@
----
-id: config-prune
-type: skill
-name: Config Prune
-description: dry-run 审计 .config 中可安全删除或合并的过期知识资产，生成分组候选清单；当用户要求清理 .config、prune config、审计知识资产过期项、或通过 command/config-prune 调用时使用。
----
-
-# Config Prune
-
-⚠️ **默认 dry-run。** 本 skill 涉及 `.config` 知识资产删除或合并，必须先列出候选清单并征求用户确认。没有确认时只输出候选清单，不删除、不重命名、不改 RULES。
-
-## 何时使用
-
-- 用户要求"清理 .config"、"prune 配置"、"审计 ADR/CONTEXT/LESSONS 过期项"
-- 用户要求"看看哪些知识资产可以删"、"检查过期的 ADR"
-- 被 `commands/config-prune.md` 或 `workflows/dev/D-docs-sync` 等调用方委托执行审计
-- 本 skill 只负责分析与生成候选清单，不自行删除文件、不自行写报告；持久化由调用方负责
-
-## 输入
-
-- `.config` 资产路径：`speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`；缺失路径记录为 `missing`，不自动创建
-- 仓库引用扫描命令：
-  ```bash
-  rg -n "ADR-[0-9]{4}|[0-9]{4}-[a-z0-9-]+\\.md|CONTEXT|LESSONS|RULES" .
-  ```
-  排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录
-- 用户确认状态（dry-run 或 confirmed）
-
-## 输出
-
-- 按 `delete | merge | rewrite | keep | needs-confirmation` 分组的候选清单
-- 每个候选包含：来源、证据、风险
-- 不产生文件型持久化产物；结构化结果返回给调用方写入
-
-## 执行步骤
-
-1. 读取 `speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`；缺失路径记录为 `missing`，不自动创建。
-2. 扫描当前仓库引用：
-   ```bash
-   rg -n "ADR-[0-9]{4}|[0-9]{4}-[a-z0-9-]+\\.md|CONTEXT|LESSONS|RULES" .
-   ```
-   排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录。
-3. 生成 dry-run 候选，至少包含：
-   - 指向不存在 ADR 的正文引用或索引行。
-   - 标记为 superseded 且超过 30 天、无活跃引用的 ADR。
-   - 只含 `.gitkeep`、TODO、空占位或模板说明的长期知识文件。
-   - CONTEXT 中当前代码、文档和归档均无证据支撑的术语。
-   - LESSONS 中重复、过期、只适用单次任务或已被 RULES/ADR 吸收的经验。
-4. 按 `delete | merge | rewrite | keep | needs-confirmation` 分组输出完整清单；每个候选必须包含来源、证据和风险。
-5. 如果用户没有明确确认，停止在 dry-run 候选清单。
-6. 用户确认后，只执行确认清单中的操作：
-   - 删除文件前再次检查路径仍位于 `speculo/.speculo/.config/`。
-   - 修改 `RULES.md` 前必须确认具体条目；不能批量隐式改规则。
-   - 执行后列出实际改动和跳过项。
-
-## 边界
-
-- 不删除仍被代码、文档、归档或 active change 引用的 ADR / CONTEXT。
-- 不把低信号归档内容写回长期知识资产。
-- 不自动解决领域术语冲突；冲突项交给 `../workflows/dev/M-domain-modeling/M-domain-modeling.md`。
-- 不修改 docs-sync state；由 `../workflows/dev/D-docs-sync/D-docs-sync.md` 推进基线。
-- 不自行选择持久化位置；文件型产物由调用方写入规范路径。
-
-## 渐进披露
-
-无 `references/`；本 skill 的完整执行规则已在入口中。

package/template/skills/grill-me/SKILL.md

@@ -1,40 +0,0 @@
----
-id: grill-me
-type: skill
-name: Grill Me
-description: 对计划、设计或决策进行逐问式压力测试；当用户要求 grill me、拷问方案、压力测试计划，或调用 command/grill-me 时使用。
----
-
-# Grill Me
-
-## 何时使用
-
-当用户想压力测试计划、设计、架构选择、实现策略或决策树，并希望逐步达成共识时使用。
-
-如果问题可以通过探索代码库回答，先探索代码库，不把可查事实推回给用户。
-
-## 输入
-
-- 待拷问的计划、设计、架构选择或实现策略
-- 用户已表达的约束、偏好、风险承受度和成功标准
-- 可通过仓库探索确认的事实
-
-## 输出
-
-- 每轮一个问题
-- 每个问题附带推荐答案
-- 已锁定决策、剩余开放点和依赖关系的简短摘要
-- 需要持久化时，由调用方 command 或 workflow 归档摘要
-
-## 执行步骤
-
-1. 识别当前最影响方案正确性的未决问题。
-2. 如果答案能通过本地代码、文档或配置确认，先读取相关材料。
-3. 每次只问一个问题，避免问题组。
-4. 对每个问题给出推荐答案，并说明推荐理由。
-5. 用户回答后更新已锁定决策和剩余分支。
-6. 继续遍历决策树，直到核心分支达成共识或用户停止。
-
-## 渐进披露
-
-无额外文件。该 skill 的完整执行规则在本入口中。

package/template/skills/handoff/SKILL.md

@@ -1,50 +0,0 @@
----
-id: handoff
-type: skill
-name: Handoff
-description: 将当前对话压缩成交接文档；当用户需要另一个 agent、另一个会话或 command/handoff 接手继续工作时使用。
----
-
-# Handoff
-
-## 何时使用
-
-当当前上下文需要交给另一个 agent、另一个会话或异步执行者继续时使用。
-
-如果用户提供参数，把参数视为下一次会话的重点，并据此调整交接文档的内容取舍。
-
-## 输入
-
-- 当前对话目标、已完成工作和未完成事项
-- 已修改或需要关注的文件路径、命令、测试结果和阻塞点
-- 用户提供的下一次会话重点
-- 可推荐给下一个 agent 的 skill 名称
-
-## 输出
-
-- 保存到规范命令产物目录的脱敏交接文档：`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`
-- 文档路径、主题目录名和命名依据
-- 3-5 条极简摘要
-- 推荐技能清单
-
-## 命名与位置
-
-- 交接文档必须写入调用方命令产物目录：`speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`。
-- `<YYYY-MM-DD>` 使用当前日期。
-- `<topic>` 从用户目标、项目名、变更名或下一次会话重点提取，使用小写 kebab-case；无法判断时使用 `session`。
-- 安装后的实际项目位置是 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/handoff.md`。
-- 禁止写入 `temp/`、系统临时目录、仓库根目录临时文件或其他非 Speculo 规范位置。
-
-## 执行步骤
-
-1. 收集当前目标、背景、已做工作、关键文件、验证结果、剩余风险和下一步。
-2. 删除 API key、密码、token、个人身份信息和其他敏感内容。
-3. 不复制 PRD、计划、ADR、issue、commit、diff 或其他已有产物正文；改用路径、URL 或 commit 引用。
-4. 添加 `推荐技能` 部分，列出下一个 agent 应优先读取或调用的技能。
-5. 创建 `speculo/.speculo/commands/<YYYY-MM-DD>-handoff-<topic>/`，并把交接文档写入其中的 `handoff.md`。
-6. 返回文档路径、主题目录名、3-5 条极简摘要和推荐技能清单。
-
-## references/ 与 scripts/
-
-- 无 `references/` 子文档；该 skill 的完整执行规则在本入口中。
-- 无 `scripts/`；直接按本文件步骤整理和写入交接文档。

package/template/skills/scaffold-exercises/SKILL.md

@@ -1,41 +0,0 @@
----
-id: scaffold-exercises
-type: skill
-name: Scaffold Exercises
-description: 创建课程章节与练习目录骨架并验证 lint；当用户要求 scaffold exercises、创建练习桩、设置课程章节，或调用 command/scaffold-exercises 时使用。
----
-
-# Scaffold Exercises
-
-## 何时使用
-
-当项目包含课程练习结构，用户要求创建章节、练习、`problem/`、`solution/` 或 `explainer/` 桩时使用。
-
-## 输入
-
-- 章节和练习计划、编号、名称和变体类型
-- 项目中的练习根目录，默认 `exercises/`
-- 项目的 lint 命令，默认 `pnpm ai-hero-cli internal lint`
-- git 操作要求，例如是否需要 `git mv`、是否需要提交
-
-## 输出
-
-- 创建或移动的练习目录清单
-- 每个练习变体的 `readme.md` 桩
-- lint 运行结果和修复摘要
-- 如用户或调用方要求提交，输出 commit hash 或无法提交原因
-
-## 执行步骤
-
-1. 读取 `references/exercise-structure.md`，确认章节、练习、变体和必需文件规则。
-2. 从计划中提取章节名、练习名、编号和变体；缺失变体时默认使用 `explainer/`。
-3. 创建目录前列出影响路径；涉及重命名时使用 `git mv`。
-4. 为每个变体创建最小但非空的 `readme.md`。
-5. 运行 lint；按 `references/lint-and-git.md` 迭代修复，直到通过或记录阻塞。
-6. 仅在用户或调用方明确要求时提交 git。
-7. 不自行选择持久化目录；需要归档时，由调用方 command 或 workflow 写入其声明的 `speculo/.speculo/...` 规范路径。
-
-## 渐进披露
-
-- `references/exercise-structure.md`：解析章节、练习编号、变体目录和必需文件时读取。
-- `references/lint-and-git.md`：运行 lint、修复练习结构错误、移动目录或提交时读取。