@namewta/speculo 0.1.21 → 0.2.0

package/template/workflows/doc/S-writing-shape/writing-shape-block.md

@@ -1,32 +0,0 @@
-# Block Shaping Phase
-
-## 输入
-
-- 用户选定的开头与当前文章
-- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
-- `speculo/.speculo/doc/<change>/shape-log.md`
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
-
-## 填写引导
-
-1. 每轮先问：基于当前文章，读者接下来需要听到什么。
-2. 从素材堆中抽取 fragment，改写以适配上下文段落。
-3. 公开讨论格式选择：散文、列表、表格、callout、引用、代码块。
-4. 如果素材堆缺少文章需要的东西，明确指出缺口，让用户补充或删除相关章节。
-5. 每个块达成一致后重新读取 `article.md`，再追加。
-6. 如果用户想重写某段，只原地编辑那个具体段落。
-
-## 边界
-
-- 不挖掘素材堆中不存在的新 fragments；只指出缺口。
-- 不编辑原始素材文件。
-- 不发布或适配特定平台格式，除非用户明确要求。
-
-## 完成准则
-
-- 每个新增块都有明确作用和格式选择记录
-- `shape-log.md` 已记录重要删改、缺口和格式争议
-- `article.md` 无残留 `[TODO:]`

package/template/workflows/doc/S-writing-shape/writing-shape-opening.md

@@ -1,27 +0,0 @@
-# Opening Choice Phase
-
-## 输入
-
-- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
-- `speculo/.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/shape-log.md`，由 `../_templates/writing-shape-log-template.md` 填写或追加
-
-## 填写引导
-
-1. 完整读取素材堆，形成整体理解。
-2. 起草 2-3 个候选开头；每个开头暗示文章不同论点或角度。
-3. 全部展示给用户，要求选择一个或组合出混合版本。
-4. 记录被选开头承诺了什么；后续所有段落都必须服务这个承诺，或推动用户修改开头。
-
-## 边界
-
-- 不编辑素材文件。
-- 不在用户选择前写入文章正文。
-
-## 完成准则
-
-- `shape-log.md` 已记录候选开头、推荐选项、用户选择和开头承诺
-- `.status.json` 的 `opening_status` 已更新

package/template/workflows/doc/T-teach/T-teach.md

@@ -1,64 +0,0 @@
----
-id: doc/teach
-category: doc
-name: Teaching Design
-description: 设计交互式学习体验：确立使命、策展资源、构建术语、制作课程、记录洞察
-keywords: [teach, lesson, learning, glossary, 教学, 课程, 术语, 学习]
----
-
-# Teaching Design 工作流执行指引
-
-本工作流是 `doc/T` 入口：围绕学习主题设计交互式教学体验（使命→资源→课程→参考→记录）。
-
-> **产物目录：** `speculo/.speculo/doc/<change>/`。`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`。
-
-## 核心理念
-
-深度学习需要 Knowledge（高质量资源）、Skills（交互式课程）与 Wisdom（实践互动）。留存设计原则：retrieval practice、spacing、interleaving。每节课短小、给一个具体胜利，控制在学习者工作记忆容量内。
-
-Lesson 铁律与 HTML 课程结构见 `teach-lesson.md` 与 `../_templates/teach-lesson-html-template.md`。
-
-## 阶段
-
-| Phase | id | 规范 | 模板 | 产物 |
-|-------|-----|------|------|------|
-| 1. Mission Setup | `mission-setup` | `teach-mission.md` | `../_templates/teach-mission-template.md` | `mission.md` |
-| 2. Resources Curation | `resources-curation` | `teach-resources.md` | `../_templates/teach-resources-template.md` | `resources.md` |
-| 3. Lesson Design | `lesson-design` | `teach-lesson.md` | `../_templates/teach-lesson-html-template.md` | `lessons/<编号>.html` |
-| 4. Lesson Wrap | `lesson-wrap` | `teach-lesson-wrap.md` | glossary + learning-record 模板 | `reference/<编号>.html` 等 |
-
-Phase 3 ↔ 4 为紧密循环：每节课程完成后立即收尾。`current_loop` 映射：`mission-setup` | `resources-curation` | `lesson-design` | `lesson-wrap`。
-
-### 1. Mission Setup — 确立学习使命
-- id：`mission-setup`
-- 完成准则：`mission.md` 无残留 `[TODO:]`；成功标准可观测
-
-### 2. Resources Curation — 策展可信资源
-- id：`resources-curation`
-- 完成准则：`resources.md` 无残留 `[TODO:]`；至少一条高信任度资源
-
-### 3. Lesson Design — 设计一节交互式课程
-- id：`lesson-design`
-- 完成准则：课程关联 `mission.md`；编号递增
-
-### 4. Lesson Wrap — 课程收尾
-- id：`lesson-wrap`
-- 完成准则：参考文档与 GLOSSARY 已更新
-
-## 依赖
-
-- 硬依赖：Phase 1 → Phase 2
-- 软依赖：Phase 2 → Phase 3
-
-## 状态扩展字段
-
-- `doc_entry` (string) — 固定为 `doc/T`
-- `mission_status` (drafting | confirmed)
-- `resource_count`、`lesson_count`、`reference_count`、`learning_record_count`、`glossary_term_count` (number)
-- `current_loop` (mission-setup | resources-curation | lesson-design | lesson-wrap)
-
-## 完成与状态更新
-
-- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
-- Phase 3-4 循环时更新 `lesson_count` 等计数。
-- 用户声明学习目标全部达成后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`。

package/template/workflows/doc/T-teach/teach-lesson-wrap.md

@@ -1,63 +0,0 @@
-# Lesson Wrap Phase
-
-本阶段在每节课程完成后立即执行，产出该课的压缩参考文档、更新术语表，并在产生非显而易见的洞察时写学习记录。
-
-## 输入
-
-- `speculo/.speculo/doc/<change>/lessons/<编号>.html` — 刚完成的课程
-- `speculo/.speculo/doc/<change>/GLOSSARY.md` — 已有术语表（若不存在则创建）
-- `speculo/.speculo/doc/<change>/learning-records/` — 已有学习记录
-- `speculo/.speculo/doc/<change>/NOTES.md` — 用户教学偏好
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/reference/<编号>.html` — 本节课程的压缩参考文档
-- `speculo/.speculo/doc/<change>/GLOSSARY.md` — 更新后的术语表
-- `speculo/.speculo/doc/<change>/learning-records/<编号>.md` — 可选，仅当产生了非显而易见的洞察
-- `speculo/.speculo/doc/<change>/NOTES.md` — 可选，仅当用户表达了新的教学偏好
-
-## 填写引导
-
-### 创建参考文档
-
-1. 从刚完成的课程中提取最核心的内容——语法、算法、步骤、要点。
-2. 写成紧凑的 HTML 速查文档，设计上适合打印。干净排版，易扫读。
-3. 链接回原课程 HTML 和术语表中的相关条目。
-4. 参考文档是课程被复习时的入口——课程很少被重看，参考文档会。
-
-### 更新术语表
-
-1. 仅当用户在本课中**真正理解**了某个术语时才收录——术语表是压缩知识的记录，不是字典。
-2. 每条定义 1-2 句，说清术语**是什么**，不说它做什么或怎么做。
-3. 有多个同义词时选最佳者，其余标为「避免使用」。
-4. 术语表自身术语应互相引用——一旦一个术语入库，后续定义优先使用它。
-5. 用户理解加深时在原文上修订，不留过时条目。
-
-### 写学习记录（可选）
-
-仅当以下任一条件成立时写：
-
-1. 用户展示了非显而易见的真正理解
-2. 用户披露了先验知识（避免后续重新教）
-3. 一个误解被纠正（高价值：预测后续相关主题的绊脚石）
-4. 使命因学习而改变（更新 mission.md 并交叉引用）
-
-学习记录是精简的 ADR：1-3 句写清学到了什么以及为什么这会影响后续课程。编号从已有最高 +1。
-
-### 更新 NOTES.md
-
-若用户在本课中表达了教学偏好（如「我更想要视频」「不要太多术语」「多给练习」），记录到 NOTES.md 供后续课程设计参考。
-
-## 边界
-
-- 不写入用户尚未真正理解的术语。
-- 学习记录不记「已覆盖了某内容」——覆盖不等于学会。
-- 不重复术语表中已有的内容到学习记录中。
-
-## 完成准则
-
-- 参考文档已创建在 `reference/<编号>.html`
-- 用户本课真正理解的术语已收录进 `GLOSSARY.md`（或确认无需新增）
-- 若产生符合条件的学习洞察，已写 learning record
-- 若用户表达了新偏好，已更新 `NOTES.md`
-- `.status.json` 已更新 `lesson_count`、`reference_count`、`glossary_term_count`、`learning_record_count`

package/template/workflows/doc/T-teach/teach-lesson.md

@@ -1,53 +0,0 @@
-# Lesson Design Phase（主循环）
-
-本阶段是教学设计的核心循环。每次执行只设计**一节**课程，完成后进入 Phase 4 收尾，再回到本阶段设计下一节。
-
-## 输入
-
-- `speculo/.speculo/doc/<change>/mission.md` — 教学使命
-- `speculo/.speculo/doc/<change>/resources.md` — 可信资源
-- `speculo/.speculo/doc/<change>/GLOSSARY.md` — 已有术语（若存在）
-- `speculo/.speculo/doc/<change>/learning-records/` — 已有学习记录
-- `speculo/.speculo/doc/<change>/NOTES.md` — 用户教学偏好（若存在）
-- `speculo/.speculo/doc/<change>/lessons/` — 已有课程（判断最近发展区）
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/lessons/<编号>.html`，按 `T-teach.md` 内置指引中的课程结构模板创建
-- 编号规则：扫描 `lessons/` 下已有最高编号 +1，起始 `0001`
-
-## 填写引导
-
-1. **判断最近发展区**：
-   - 读取已有 learning records 和 GLOSSARY.md，了解用户已知什么
-   - 基于使命中尚未覆盖的 Success 项，选择下一个该教的内容
-   - 教能放进最近发展区的最相关内容
-2. **知识先行，技能随后**：
-   - 课程前半段：从 resources.md 中的高信任度源提取知识，用最简洁的方式呈现
-   - 课程后半段：设计交互式练习或真实世界步骤，让用户实践
-   - 知识部分引用来源，每条声明有出处
-3. **设计反馈循环**：
-   - 如果是问答题，每个选项等长（避免通过格式暗示答案）
-   - 反馈尽可能即时、自动
-   - 练习的目标是建立 storage strength，不是 fluency
-4. **保持短小**：课程应在几分钟内完成。如果知识或练习过多，拆成多节。
-5. **关联使命**：课程开头一句话说明本节如何贡献于使命中的哪个 Success 项。
-6. **链向其他材料**：通过 HTML 锚点链向已有术语表、参考文档和相关课程。
-7. **每节课程末尾**：推荐一个一手资料（从 resources.md 中选取）+ 提示用户可追问 AI 教师。
-8. **创建后**：尝试自动打开 HTML 文件供用户查看。
-
-## 边界
-
-- 每次只设计一节课程，不批量预写后续课程。
-- 不编造知识——所有事实性声明必须来自 resources.md 中的资源。
-- 不假设用户记得上一节的内容——可以引用但关键概念要简要回顾。
-- 不在课程中加入超出使命范围的话题。
-
-## 完成准则
-
-- 课程 HTML 已创建在 `lessons/<编号>.html`
-- 课程短小（几分钟内可完成）
-- 课程包含知识部分（有引用来源）+ 技能练习部分（有反馈循环）
-- 课程关联使命中的具体 Success 项
-- 课程包含一手资料推荐和 AI 追问提示
-- `T-teach.md` 内置指引的课程铁律已全部满足

package/template/workflows/doc/T-teach/teach-mission.md

@@ -1,33 +0,0 @@
-# Mission Setup Phase
-
-## 输入
-
-- 用户声明的学习主题或模糊兴趣
-- 用户对「为什么想学这个」的任何初始表述
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/mission.md`，由 `../_templates/teach-mission-template.md` 填写
-
-## 填写引导
-
-1. 若用户未给出具体目标，追问「你学这个最终想做到什么？」，直到得到可观测的行为描述——不是「了解 X」而是「能做 Y」。
-2. 从用户的回答中提炼 Why（1-3 句）、Success（具体可观测事项）、Constraints（时间/预算/偏好）、Out of scope（明确不做的话题）。
-3. 追问时保持具体：避免抽象框架，逼向真实世界的成果。
-4. 用户说不清时，继续访谈；坏使命比没使命更糟，但模糊使命也要被推回。
-5. 使命确立后与用户逐条确认，确认后才进入 Phase 2。
-
-## 边界
-
-- 不在此阶段搜集学习资源或设计课程。
-- 不编造用户的动机或目标——一切来自用户原话。
-- 使命可以后续修订，但修订必须经用户确认并写 learning record 记录变更原因。
-
-## 完成准则
-
-- Why / Success / Constraints / Out of scope 四段均已填写
-- 每条 Success 是可观测的、可判断是否达成的
-- 用户已逐条确认使命内容
-- `mission.md` 无残留 `[TODO:]`
-- 已创建 `NOTES.md`（空文件，用于后续记录教学偏好）

package/template/workflows/doc/T-teach/teach-resources.md

@@ -1,36 +0,0 @@
-# Resources Curation Phase
-
-## 输入
-
-- `speculo/.speculo/doc/<change>/mission.md`（已确认的使命）
-- 用户的社区偏好（是否愿意加入线上/线下社区）
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/resources.md`，由 `../_templates/teach-resources-template.md` 填写
-
-## 填写引导
-
-1. **搜罗知识源**：针对使命中的每个 Success 项，搜寻高信任度资源。
-   - 优先：一手资料、公认专家著作、同行评审、强审核社区
-   - 避开：营销伪装成教育的内容、无引用的自媒体
-2. **注解每条资源**：用一句话写清覆盖什么、何时取用。裸链接三个月后无用。
-3. **分 Knowledge / Wisdom 两组**：
-   - Knowledge：书籍、文章、课程、论文——用于获取知识
-   - Wisdom：社区、论坛、线下课——用于获取智慧
-4. **标明缺口**：若某个 Success 项找不到好资源，在 `## Gaps` 段写明。
-5. **用户选择不加入社区时**，在 Wisdom 段记录此偏好，后续课程中不再推荐社区。
-
-## 边界
-
-- 不在此阶段设计课程。
-- 不因为资源少而编造或降级标准。
-- 不在 resources.md 中写课程计划或教学大纲。
-
-## 完成准则
-
-- 已针对使命中每个 Success 项搜集至少一条高信任度知识源（或在 Gaps 中标记缺失）
-- 每条资源有注解
-- 已找到至少一个可推荐社区（或记录用户拒绝社区）
-- `resources.md` 无残留 `[TODO:]`

package/template/workflows/doc/_templates/edit-article-plan-template.md

@@ -1,25 +0,0 @@
-> **服务工作流：** `../E-edit-article/E-edit-article.md`
-> **产物文件名：** `edit-plan.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Edit Plan
-
-## 草稿来源
-
-[TODO: 记录草稿路径、版本或用户提供方式。]
-
-## 章节与主观点
-
-[TODO: 按章节列出每节主要观点。]
-
-## 信息依赖
-
-[TODO: 说明哪些信息必须先出现，哪些章节应移动、合并、删除或拆分。]
-
-## 推荐顺序
-
-[TODO: 给出推荐章节顺序和理由。]
-
-## 用户确认
-
-[TODO: 记录用户确认、修改意见或 blocked 原因。]

package/template/workflows/doc/_templates/edit-article-template.md

@@ -1,7 +0,0 @@
-> **服务工作流：** `../E-edit-article/E-edit-article.md`
-> **产物文件名：** `edited-article.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# [TODO: 编辑后文章标题]
-
-[TODO: 按确认后的章节顺序写入编辑后正文。每段默认不超过 240 个字符。]

package/template/workflows/doc/_templates/teach-glossary-template.md

@@ -1,26 +0,0 @@
-> **服务工作流：** `../T-teach/T-teach.md`
-> **产物文件名：** `GLOSSARY.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# [TODO: 学习主题] Glossary
-
-[TODO: 1-2 句描述本术语表覆盖的主题范围。]
-
-## Terms
-
-[TODO: 每个术语 1-2 句，说清它**是什么**，不说它做什么或怎么做。术语表自身术语互相引用。]
-
-**[TODO: 术语名]**：
-[TODO: 定义——术语是什么。]
-_Avoid_: [TODO: 列出应避免的同义词或不当用语]
-
-**[TODO: 术语名]**：
-[TODO: 定义。]
-_Avoid_: [TODO: 不当用语]
-
-## Rules
-- 仅在用户**真正理解**术语后才收录——术语表是压缩知识的记录，不是字典。
-- 有自己的观点：当多个词指向同一概念时，选最佳者，其余标为避免使用。
-- 定义内部使用术语表自身的术语——一旦入库，后续定义优先使用它。
-- 理解加深时在原文上修订，不留过时条目。
-- 若某术语在更广领域中用法模糊，注明本 workspace 内的约定用法。

package/template/workflows/doc/_templates/teach-learning-record-template.md

@@ -1,38 +0,0 @@
-> **服务工作流：** `../T-teach/T-teach.md`
-> **产物文件名：** `learning-records/<编号>.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-学习记录使用顺序编号：`0001-<slug>.md`、`0002-<slug>.md`。首次写入时创建目录。
-
-每一条是精简的 ADR：1-3 句写清学到了什么以及为什么这会影响后续课程。编号从已有最高 +1。
-
-## 模板
-
-```markdown
-# [TODO: 简短标题——学到了什么或建立了什么认知]
-
-[TODO: 1-3 句。学到了什么（或建立了什么先验知识），以及为什么这会影响后续课程。]
-```
-
-## 何时写
-
-仅在以下任一条件成立时写：
-
-1. **用户展示了非显而易见的真正理解** — 不是仅仅接触过，而是有证据表明能正确使用这个概念。这为后续教学设定了新底线。
-2. **用户披露了先验知识** — 「我已经知道 X」。记录下来避免后续重新教。同时记录声称的深度。
-3. **一个误解被纠正** — 用户之前相信了错误的东西，现在明白了为什么。高价值：预测后续相关主题的绊脚石。
-4. **使命因学习而改变** — 用户发现自己在意的和最初想的不同。交叉引用 `mission.md` 并更新它。
-
-### 不写的情况
-
-- 仅仅覆盖过的内容。覆盖 ≠ 学会。等证据。
-- 已被 GLOSSARY.md 精简收录的术语定义。不重复。
-- 逐节课的活动日志。学习记录不是流水账——是决策级的洞察。
-
-## 可选节
-
-仅在真正增值时加入：
-
-- **Status frontmatter**：`active | superseded by LR-NNNN` — 当早期理解被后续认知推翻时使用。
-- **Evidence**：用户如何展示理解（回答的问题、完成的练习、引用的先验经历）。
-- **Implications**：这对后续课程解锁或排除了什么。

package/template/workflows/doc/_templates/teach-lesson-html-template.md

@@ -1,24 +0,0 @@
-> **服务工作流：** `../T-teach/T-teach.md`
-> **产物文件名：** `lessons/<编号>.html`
-
-```html
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-<meta charset="UTF-8">
-<title>课程标题</title>
-<style>
-  body { max-width: 680px; margin: 2rem auto; padding: 0 1rem; font-family: system-ui; line-height: 1.7; color: #1a1a1a; }
-  h1 { font-size: 1.6rem; margin-top: 2.5rem; }
-  blockquote { border-left: 3px solid #ddd; margin-left: 0; padding-left: 1rem; color: #555; }
-  .cite { font-size: 0.85rem; color: #888; margin-top: 2rem; border-top: 1px solid #eee; padding-top: 0.5rem; }
-  .reminder { background: #f5f5f5; padding: 0.8rem 1rem; border-radius: 6px; margin-top: 2rem; font-size: 0.9rem; }
-</style>
-</head>
-<body>
-<!-- 课程内容 -->
-<div class="cite">📖 推荐一手资料：<a href="...">资源标题</a></div>
-<div class="reminder">💡 有疑问？直接问我——我是你的 AI 教师。</div>
-</body>
-</html>
-```

package/template/workflows/doc/_templates/teach-mission-template.md

@@ -1,19 +0,0 @@
-> **服务工作流：** `../T-teach/T-teach.md`
-> **产物文件名：** `mission.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Mission: [TODO: 学习主题]
-
-## Why
-[TODO: 1-3 句。用户追逐的具体真实世界目标。学会这个之后，他们的生活或工作中会发生什么改变？避免「想了解 X」这类抽象表述——逼向底层成果。]
-
-## Success looks like
-- [TODO: 一个具体的、可观测的用户将能做到的事项]
-- [TODO: 另一个具体事项]
-- [TODO: …]
-
-## Constraints
-- [TODO: 时间、预算、先验承诺、学习偏好——任何限定教学方式的约束]
-
-## Out of scope
-- [TODO: 用户明确不想现在涉及的相邻话题——保护最近发展区]

package/template/workflows/doc/_templates/teach-resources-template.md

@@ -1,18 +0,0 @@
-> **服务工作流：** `../T-teach/T-teach.md`
-> **产物文件名：** `resources.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# [TODO: 学习主题] Resources
-
-## Knowledge
-
-- [TODO: 格式：`[类型: _标题_ — 作者（出处）](链接)`，下一行缩进写用途。优先一手资料、公认专家、同行评审。]
-  [TODO: 覆盖什么、何时取用。]
-
-## Wisdom (Communities)
-
-- [TODO: 格式同 Knowledge。线上论坛、线下课、本地兴趣小组。]
-  [TODO: 用于什么场景的反馈或讨论。]
-
-## Gaps
-[TODO: 若某 Success 项找不到好资源，在此列出。用户选择不加入社区时也在本节记录。]

package/template/workflows/doc/_templates/writing-article-template.md

@@ -1,7 +0,0 @@
-> **服务工作流：** `../B-writing-beats/B-writing-beats.md` 或 `../S-writing-shape/S-writing-shape.md`
-> **产物文件名：** `article.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# [TODO: 文章标题]
-
-[TODO: 文章正文。由 workflow 每次只追加一个 beat 或一个确认后的内容块。]

package/template/workflows/doc/_templates/writing-beat-options-template.md

@@ -1,21 +0,0 @@
-> **服务工作流：** `../B-writing-beats/B-writing-beats.md`
-> **产物文件名：** `beat-log.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Beat Log
-
-## 当前文章位置
-
-[TODO: 摘要当前文章停在什么位置。]
-
-## 候选 Beats
-
-[TODO: 列出 2-3 个候选起始 beat 或下一个 beat，并说明各自通向哪里。]
-
-## 用户选择
-
-[TODO: 记录用户选择的 beat、组合要求或暂停原因。]
-
-## 写入记录
-
-[TODO: 写入后记录当前 beat 摘要和下一轮可转向方向。]

package/template/workflows/doc/_templates/writing-fragments-template.md

@@ -1,7 +0,0 @@
-> **服务工作流：** `../F-writing-fragments/F-writing-fragments.md`
-> **产物文件名：** `fragments.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# [TODO: 工作标题]
-
-[TODO: 第一个 fragment。可以是一句话、段落、列表、代码、引用或观察组。]

package/template/workflows/doc/_templates/writing-interview-log-template.md

@@ -1,21 +0,0 @@
-> **服务工作流：** `../F-writing-fragments/F-writing-fragments.md`
-> **产物文件名：** `interview-log.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Fragment Interview Log
-
-## 主题
-
-[TODO: 本轮访谈围绕的写作主题。]
-
-## 已采集素材类型
-
-[TODO: 列出主张、小场景、锋利句子、半成形想法、引用、观察组等。]
-
-## 用户偏好
-
-[TODO: 记录用户对删改、语气、保留句子的明确偏好。]
-
-## 下一轮追问
-
-[TODO: 列出 1-3 个最值得继续追问的问题。]

package/template/workflows/doc/_templates/writing-shape-log-template.md

@@ -1,25 +0,0 @@
-> **服务工作流：** `../S-writing-shape/S-writing-shape.md`
-> **产物文件名：** `shape-log.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Shape Log
-
-## 素材来源
-
-[TODO: 列出只读素材路径和读取摘要。]
-
-## 候选开头
-
-[TODO: 列出 2-3 个候选开头和各自承诺的论点。]
-
-## 已选开头
-
-[TODO: 记录用户选择或混合后的开头，以及它对后文的承诺。]
-
-## 格式决策
-
-[TODO: 记录 prose、list、table、callout、quote、code 等格式选择及理由。]
-
-## 缺口
-
-[TODO: 记录素材堆缺少的例子、证据或解释。]

package/template/workflows/person/AGENTS.md

@@ -1,72 +0,0 @@
----
-id: person/index
-category: person
-name: Person Workflow AGENTS Guide
-description: 以人物方法论为底座的工作流导航与渐进披露指引
-keywords: [person, methodology, agents, 人物, 方法论, cognitive, 认知]
----
-
-# Person Workflow AGENTS Guide
-
-> ⚠️ **持久化铁律：本文件及所有 person workflow 的全部产物，必须且只能写入 `speculo/.speculo/person/<change>/`。绝对禁止写入项目根目录的 `.speculo/`、`temp/` 或其他任何非规范位置。**
-
-本文件是 person 分类的 AGENTS 导航入口。进入时先读取 `speculo/.speculo/person-status.json`，再按其中 active change 读取 `speculo/.speculo/person/<change>/.status.json`，根据用户意图推荐横向 workflow。
-
-> **命名铁律：** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-mao-strategy-consult`）。不符合此格式的目录视为 `malformed`，仅汇报不自动操作。
-
-## 渐进披露
-
-1. 先读本文件，确认当前 person change、咨询模式和入口别名。
-2. 选定入口后，只读取对应 workflow 入口文件（如 `M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md`）。
-3. 进入具体 phase 时，再读取该 phase 文件、模板和被调用 skill wrapper。
-4. 执行中如涉及项目硬约束、跨任务经验、人物方法论上下文、术语定义、ADR 或决策依据，必须参考 `../../.speculo/.config/` 下对应文件；`RULES.md` 的约束高于普通 workflow 文案。
-5. 需要理解状态骨架、archive 或 `.config` 时，读取 `../../.speculo/AGENTS.md` 和相关子目录的 `AGENTS.md`。
-
-## 入口别名
-
-| 别名 | 入口 | 用途 |
-|------|------|------|
-| `person/M` | `M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md` | 以毛泽东方法论为底座的认知咨询：分析问题→制定战略→组织行动 |
-
-## 进入协议
-
-1. 若用户未指定 change，扫描 `speculo/.speculo/person-status.json` 和 `speculo/.speculo/person/*/.status.json`，列出 active changes。
-   - **命名校验**：扫描时仅处理符合 `YYYY-MM-DD-<kebab-name>` 格式的目录。不符合的目录标记为 `malformed`，单独列出路径并提示用户修复或手动清理，不自动删除或重命名。
-2. 若只有一个 active change，默认继续该 change；若有多个 active change，要求用户选择。
-3. 若没有 active change，按用户意图创建新的 person change。**以下三步为原子操作，不可跳过，前一步失败时停止后续并报告：**
-   - **3a. 创建 change 目录** —— `speculo/.speculo/person/<YYYY-MM-DD>-<kebab-name>/`（使用当前日期，`<kebab-name>` 从用户意图提取，不超过 5 个词）。
-   - **3b. 写入 `.status.json`** —— 在 change 目录下创建 `.status.json`，按 `../../skills/speculo-write/references/persistence-contract-sop.md` 最小初始化模板填入所有必填字段（`name`、`category: "person"`、`change_status: "active"`、`created_at`、`updated_at`、`current_phase: "00-init"`、`phase_history`）。
-   - **3c. 更新 `person-status.json`** —— 读取 `speculo/.speculo/person-status.json`，在 `active[]` 中追加该 change 的索引条目（`name`、`current_phase: "00-init"`、`updated_at`），写回文件。
-   - 以上三步全部成功后，方可继续推荐入口。
-4. 推荐入口时优先使用用户显式别名；没有别名时按用户意图推荐一个横向 workflow。
-5. 执行任何 workflow 前，读取该 workflow 入口文件、阶段文件和模板。
-6. 执行中一旦需要项目规则、经验、上下文、术语或 ADR，先读取 `../../.speculo/.config/`，再继续判断或写入产物；除非用户明确要求或规则允许，不自动改写 `.config/`。
-
-## 执行模式
-
-- `mao`：以毛泽东方法论进行结构化认知咨询——分析问题、制定战略、组织行动，进入 `person/M`。
-
-## 状态汇报
-
-输出 person 状态时至少包含：
-
-- active change 数量与每个 change 的 `current_phase`
-- malformed 目录清单（不符合 `YYYY-MM-DD-<kebab-name>` 格式的目录）
-- 每个 change 的当前文档路径、素材路径和最近写入时间
-- `phase_history` 最后一项为 `blocked` 或 `updated_at` 超过 14 天未变化的 change
-- 推荐下一步入口和原因
-
-## 续跑协议
-
-1. 读取 change 目录下 `.status.json` 的 `current_phase` 与 `phase_history`。
-2. 跳过 `status: completed` 的 phase；从 `in-progress`、`blocked` 或首个 `pending` phase 继续。
-3. 根据 `current_phase` 匹配 workflow 入口 `## 阶段` 中的机器 id，只读取对应 phase 文件与模板。
-4. 首个 workflow 进入 change 时写入 `execution_mode`（使用入口声明的执行模式名或用户指定别名）。
-5. 不得因续跑而重复创建 change 或重写已完成的 phase 产物。
-
-## 完成与状态更新
-
-- 所有 person workflow 必须维护同一 change 的 `.status.json`。
-- 进入 phase 时更新 `current_phase`，并在 `phase_history` 追加 `in-progress` 记录。
-- phase 完成时写入 `completed_at` 和 `status: completed`。
-- 用户确认咨询输出或分析边界完成后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`（person 分类无 finalize workflow）。