@namewta/speculo 0.1.21 → 0.2.0

package/template/workflows/dev/_templates/tdd-plan-template.md

@@ -1,35 +0,0 @@
-> **服务工作流：** `../03-tdd/03-tdd.md`
-> **产物文件名：** `tdd/<phase-id>/tdd-plan.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# TDD Plan
-
-## 阶段标识
-[TODO: 本阶段 `<phase-id>`。多阶段 slices 须与 slices `<phase>` 的 `id` 一致（如 `phase0-node-base`）；单阶段 change 用描述性切片 slug。产物落 `tdd/<phase-id>/`。]
-
-## 切片来源
-[TODO: 记录来自 PRD、slices、diagnosis 还是用户直接请求。]
-
-## 执行前 Git 基线
-[TODO: 记录当前分支、`git status --short --branch` 摘要、`git diff --stat`、`git diff --cached --stat`。若不是 git 仓库或命令失败，记录原因。]
-
-## 保留/不动（约束）
-[TODO: 承接本切片「保留/不动」：实现中不能碰的代码/契约/数据（冻结常量、共享依赖、邻近功能）；无则写「无」。]
-
-## 现场核对（关键核实结论复核）
-[TODO: 承接本切片「关键核实结论」，并以现场代码复核其依赖/调用点/边界；切片行号为近似，记录现场实际位置。]
-
-## 公共接口
-[TODO: 描述需要新增或修改的公共接口、命令、页面、API 或模块边界。]
-
-## 行为优先级
-[TODO: 列出最重要的可观察行为和测试优先级。]
-
-## 第一个 Tracing Slice
-[TODO: 描述第一条端到端薄切片、失败信号和成功判据。]
-
-## 验证命令
-[TODO: 列出应运行的测试、类型检查、lint 或构建命令。]
-
-## 验收切片（承接 slices）
-[TODO: 承接本切片「验收切片」：Finish 阶段须运行的可独立验证命令/步骤；删除型切片含残留扫描（`grep` 应 0 命中）。]

package/template/workflows/dev/_templates/tdd-verification-template.md

@@ -1,26 +0,0 @@
-> **服务工作流：** `../03-tdd/03-tdd.md`
-> **产物文件名：** `tdd/<phase-id>/verification.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# Verification
-
-## 阶段标识
-[TODO: 本阶段 `<phase-id>`（与同目录 `tdd-plan.md` 一致）。]
-
-## 已运行命令
-[TODO: 列出实际运行的测试、类型检查、lint 或构建命令及结果。]
-
-## 验收切片结果（含残留扫描）
-[TODO: 承接 slices 本切片「验收切片」的运行结果；删除型切片记录残留扫描命令与命中数（应 0）。]
-
-## 未运行命令
-[TODO: 列出未运行但相关的命令，以及原因。]
-
-## 调试残留检查
-[TODO: 记录临时日志、DEBUG 标记、一次性脚本和推测性功能的清理结果。]
-
-## 保留/不动核对
-[TODO: 核对实现未触碰本切片「保留/不动」清单（冻结常量 / 共享依赖 / 邻近功能）；逐项标 OK 或说明偏离。]
-
-## 完成结论
-[TODO: 说明 change 是否已完成、仍被阻塞或需要后续 review/handoff。]

package/template/workflows/doc/AGENTS.md

@@ -1,80 +0,0 @@
----
-id: doc/index
-category: doc
-name: Doc Workflow AGENTS Guide
-description: 文档写作、塑形、编辑与素材管理的横向工作流导航与渐进披露指引
-keywords: [doc, writing, article, fragments, edit, agents, 文档, 写作]
----
-
-# Doc Workflow AGENTS Guide
-
-> ⚠️ **持久化铁律：本文件及所有 doc workflow 的全部产物，必须且只能写入 `speculo/.speculo/doc/<change>/`。绝对禁止写入项目根目录的 `.speculo/`、`temp/` 或其他任何非规范位置。**
-
-本文件是 doc 分类的 AGENTS 导航入口。进入时先读取 `speculo/.speculo/doc-status.json`，再按其中 active change 读取 `speculo/.speculo/doc/<change>/.status.json`，根据用户意图推荐横向 workflow。
-
-> **命名铁律：** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-draft`）。不符合此格式的目录视为 `malformed`，仅汇报不自动操作。
-
-## 渐进披露
-
-1. 先读本文件，确认当前 doc change、写作模式和入口别名。
-2. 选定入口后，只读取对应 workflow 入口文件（如 `S-writing-shape/S-writing-shape.md`）。
-3. 进入具体 phase 时，再读取该 phase 文件、模板和被调用 skill wrapper。
-4. 执行中如涉及项目硬约束、跨任务经验、写作上下文、术语定义、ADR 或决策依据，必须参考 `../../.speculo/.config/` 下对应文件；`RULES.md` 的约束高于普通 workflow 文案。
-5. 需要理解状态骨架、archive 或 `.config` 时，读取 `../../.speculo/AGENTS.md` 和相关子目录的 `AGENTS.md`。
-
-## 入口别名
-
-| 别名 | 入口 | 用途 |
-|------|------|------|
-| `doc/T` | `T-teach/T-teach.md` | 设计交互式课程：使命→资源→课程→参考→记录 |
-| `doc/F` | `F-writing-fragments/F-writing-fragments.md` | 追问式访谈，沉淀异质 fragment 素材 |
-| `doc/B` | `B-writing-beats/B-writing-beats.md` | 逐个 beat 推进文章旅程 |
-| `doc/S` | `S-writing-shape/S-writing-shape.md` | 读取素材堆并对话式塑造成文章 |
-| `doc/E` | `E-edit-article/E-edit-article.md` | 重组章节、提升清晰度并收紧表达 |
-
-## 进入协议
-
-1. 若用户未指定 change，扫描 `speculo/.speculo/doc-status.json` 和 `speculo/.speculo/doc/*/.status.json`，列出 active changes。
-   - **命名校验**：扫描时仅处理符合 `YYYY-MM-DD-<kebab-name>` 格式的目录。不符合的目录标记为 `malformed`，单独列出路径并提示用户修复或手动清理，不自动删除或重命名。
-2. 若只有一个 active change，默认继续该 change；若有多个 active change，要求用户选择。
-3. 若没有 active change，按用户意图创建新的 doc change。**以下三步为原子操作，不可跳过，前一步失败时停止后续并报告：**
-   - **3a. 创建 change 目录** —— `speculo/.speculo/doc/<YYYY-MM-DD>-<kebab-name>/`（使用当前日期，`<kebab-name>` 从用户意图提取，不超过 5 个词）。
-   - **3b. 写入 `.status.json`** —— 在 change 目录下创建 `.status.json`，按 `../../skills/speculo-write/references/persistence-contract-sop.md` 最小初始化模板填入所有必填字段（`name`、`category: "doc"`、`change_status: "active"`、`created_at`、`updated_at`、`current_phase: "00-init"`、`phase_history`）。
-   - **3c. 更新 `doc-status.json`** —— 读取 `speculo/.speculo/doc-status.json`，在 `active[]` 中追加该 change 的索引条目（`name`、`current_phase: "00-init"`、`updated_at`），写回文件。
-   - 以上三步全部成功后，方可继续推荐入口。
-4. 推荐入口时优先使用用户显式别名；没有别名时按用户意图推荐一个横向 workflow。
-5. 执行任何 workflow 前，读取该 workflow 入口文件、阶段文件和模板。
-6. 执行中一旦需要项目规则、经验、上下文、术语或 ADR，先读取 `../../.speculo/.config/`，再继续判断或写入产物；除非用户明确要求或规则允许，不自动改写 `.config/`。
-
-## 执行模式
-
-- `teach`：想学某个主题，需要设计交互式课程体验，进入 `doc/T`。
-- `fragments`：从主题和对话中采集素材，进入 `doc/F`。
-- `beats`：已有素材，想逐个转向推进叙事，进入 `doc/B`。
-- `shape`：已有素材堆或粗稿，想塑造成可发布文章，进入 `doc/S`。
-- `edit`：已有文章草稿，想编辑、重组、润色，进入 `doc/E`。
-
-## 状态汇报
-
-输出 doc 状态时至少包含：
-
-- 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 产物。
-
-## 完成与状态更新
-
-- 所有 doc workflow 必须维护同一 change 的 `.status.json`。
-- 进入 phase 时更新 `current_phase`，并在 `phase_history` 追加 `in-progress` 记录。
-- phase 完成时写入 `completed_at` 和 `status: completed`。
-- 用户确认文章、素材采集或编辑边界完成后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`（doc 分类无 finalize workflow）。

package/template/workflows/doc/B-writing-beats/B-writing-beats.md

@@ -1,79 +0,0 @@
----
-id: doc/writing-beats
-category: doc
-name: Writing Beats
-description: 从素材堆中选择起始 beat，并逐个 beat 推进文章旅程
-keywords: [beats, narrative, article, writing, 叙事, 文章]
----
-
-# Writing Beats 工作流执行指引
-
-本工作流用于把文章塑造成一段由 beat 组成的旅程。用户从原始素材中选择起始 beat；执行者只写当前 beat，然后给出下一步转向选项，直到文章自然结束。
-
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `speculo/.speculo/doc/<change>/`。
-
-## 内置指引
-
-### 何时使用
-
-当用户已有原始素材，并想把它组织成叙事旅程而不是一次性论证时使用。
-
-### 输入
-
-- 用户提供的原始素材 Markdown 路径，或同 change 的 `fragments.md`
-- 当前文章文件：默认 `speculo/.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-article-notes`）
-
-### 输出
-
-- `speculo/.speculo/doc/<change>/article.md`
-- `speculo/.speculo/doc/<change>/beat-log.md`
-- 每轮 2-3 个候选下一个 beat
-
-### 执行原则
-
-beat 是旅程中的一个动作：铺开一个场景、落下一个观点、提出一个问题、插入旁白或扭转角度。一个 beat 可以是一句话、一小段或几段；如果需要 5 段和 3 个小标题，它就不是一个 beat，必须拆开。
-
-每次只追加一个 beat。不要提前写后续内容。每次写入前都从磁盘重新读取 `article.md`，保留用户编辑。用户要求重写某个 beat 或回到某个 beat 试另一个方向时，只编辑对应区域。
-
-文章在旅程完成时结束，不要求素材堆清空。
-
-## 阶段
-
-### 1. Beat Options — 候选 beat
-- 规范：`writing-beats-options.md`
-- 模板：`../_templates/writing-beat-options-template.md`
-- 产物：`beat-log.md`
-- 完成准则：
-  - 已展示 2-3 个候选起始或下一个 beat
-  - 已记录用户选择和选择理由
-
-### 2. Beat Append — 写入当前 beat
-- 规范：`writing-beats-append.md`
-- 模板：`../_templates/writing-article-template.md`
-- 产物：`article.md`
-- 完成准则：
-  - 只写入当前选定 beat
-  - 写入前已重新读取 `article.md`
-  - `article.md` 无残留 `[TODO:]`
-
-## 依赖
-
-- 软依赖：`../F-writing-fragments/F-writing-fragments.md`，scope: same-change
-- 硬依赖：无；用户也可以直接提供素材文件
-
-## 状态扩展字段
-
-本工作流需在同 change 的 `.status.json` 追加：
-
-- `doc_entry` (string) — 固定为 `doc/B`
-- `source_material_paths` (array) — 素材来源路径
-- `document_paths` (array) — 至少包含 `article.md` 和 `beat-log.md`
-- `beat_count` (number) — 已写入 beat 数量
-- `current_beat_status` (choosing | appended | revising | completed | blocked) — 当前 beat 状态
-
-## 完成与状态更新
-
-- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
-- 每次写入 beat 后更新 `beat_count`、`current_beat_status` 和 `updated_at`。
-- 文章自然结束且用户确认后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`。

package/template/workflows/doc/B-writing-beats/writing-beats-append.md

@@ -1,31 +0,0 @@
-# Beat Append Phase
-
-## 输入
-
-- 用户在 Beat Options 阶段选择的 beat
-- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
-- `speculo/.speculo/doc/<change>/article.md`
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
-
-## 填写引导
-
-1. 写入前重新读取 `article.md`。
-2. 从素材堆中抽取内容来填充当前 beat，可以改写、拆分、重组或引用。
-3. 只写当前 beat，写完就停。
-4. beat 长度由它自身需要决定；过长时拆成后续 beat。
-5. 写入后更新 `beat-log.md`，记录实际写入摘要和下一轮可转向方向。
-
-## 边界
-
-- 不提前写下一个 beat。
-- 不忽略用户在上一轮之后对文章做的编辑。
-- 不因为素材未用完而强行继续。
-
-## 完成准则
-
-- 当前 beat 已写入 `article.md`
-- 已更新 `.status.json` 的 `beat_count` 和 `current_beat_status`
-- `article.md` 无残留 `[TODO:]`

package/template/workflows/doc/B-writing-beats/writing-beats-options.md

@@ -1,29 +0,0 @@
-# Beat Options Phase
-
-## 输入
-
-- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
-- `speculo/.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
-- `speculo/.speculo/doc/<change>/beat-log.md`
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/beat-log.md`，由 `../_templates/writing-beat-options-template.md` 填写或追加
-
-## 填写引导
-
-1. 完整读取素材和当前文章。
-2. 若文章为空，提出 2-3 个候选起始 beat；每个代表不同入口。
-3. 若文章已有内容，提出 2-3 个候选下一个 beat；每个代表从当前位置可以转向的不同方向。
-4. 候选只做预览，不写入 `article.md`。
-5. 要求用户选择一个候选，或组合出混合版本。
-
-## 边界
-
-- 不一次性规划完整提纲。
-- 不写入文章正文。
-
-## 完成准则
-
-- `beat-log.md` 已记录候选、推荐选项、用户选择或 blocked 原因
-- 用户已选择当前要写的 beat，或明确要求暂停

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

@@ -1,79 +0,0 @@
----
-id: doc/edit-article
-category: doc
-name: Edit Article
-description: 通过重组章节、提升清晰度、收紧表达来编辑和改进文章草稿
-keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
----
-
-# Edit Article 工作流执行指引
-
-本工作流用于编辑已有文章草稿。先按标题和信息依赖确认章节顺序，再逐节重写，提升清晰度、连贯性和流畅度。
-
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
-
-## 内置指引
-
-### 何时使用
-
-当用户想编辑、修订、改进文章草稿，或要求重组章节、收紧表达、提升清晰度时使用。
-
-### 输入
-
-- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
-- 用户明确的发布目标、语气偏好或约束
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-edit-article`）
-
-### 输出
-
-- `speculo/.speculo/doc/<change>/edit-plan.md`
-- `speculo/.speculo/doc/<change>/edited-article.md`
-- 已确认的章节顺序、依赖关系和逐节编辑结果
-
-### 执行原则
-
-首先根据标题把文章分成多个章节，思考每个章节表达的主要观点。把信息视为有向无环图：某些信息片段依赖其他信息片段，章节顺序和内容顺序必须尊重这些依赖。
-
-与用户确认章节后再逐节重写。每段最多 240 个字符。编辑时优先提升清晰度、连贯性和流畅度，不改变用户没有授权改变的核心主张。
-
-## 阶段
-
-### 1. Edit Plan — 章节与依赖确认
-- 规范：`edit-article-plan.md`
-- 模板：`../_templates/edit-article-plan-template.md`
-- 产物：`edit-plan.md`
-- 完成准则：
-  - 已按章节列出主观点和依赖关系
-  - 用户已确认章节顺序或给出修改意见
-  - `edit-plan.md` 无残留 `[TODO:]`
-
-### 2. Section Rewrite — 逐节重写
-- 规范：`edit-article-rewrite.md`
-- 模板：`../_templates/edit-article-template.md`
-- 产物：`edited-article.md`
-- 完成准则：
-  - 已按确认顺序逐节编辑
-  - 每段不超过 240 个字符，除非用户明确要求保留长段
-  - `edited-article.md` 无残留 `[TODO:]`
-
-## 依赖
-
-- 软依赖：`../S-writing-shape/S-writing-shape.md` 或 `../B-writing-beats/B-writing-beats.md`，scope: same-change
-- 硬依赖：无；用户也可以直接提供草稿文件
-
-## 状态扩展字段
-
-本工作流需在同 change 的 `.status.json` 追加：
-
-- `doc_entry` (string) — 固定为 `doc/E`
-- `draft_paths` (array) — 草稿来源路径
-- `document_paths` (array) — 至少包含 `edit-plan.md` 和 `edited-article.md`
-- `section_count` (number) — 已识别章节数
-- `edit_status` (planning | rewriting | reviewed | completed | blocked) — 编辑状态
-
-## 完成与状态更新
-
-- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
-- 完成 edit plan 后更新 `section_count` 和 `edit_status`。
-- 每节重写后更新 `updated_at` 和 `edit_status`。
-- 用户确认 edited article 完成后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`。

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

@@ -1,30 +0,0 @@
-# Edit Plan Phase
-
-## 输入
-
-- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
-- 用户明确的语气、长度、发布目标和不可改变的主张
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/edit-plan.md`，由 `../_templates/edit-article-plan-template.md` 填写
-
-## 填写引导
-
-1. 完整读取草稿。
-2. 根据标题和内容把文章分成章节。
-3. 为每个章节写出主要观点。
-4. 把信息依赖视为有向无环图，检查章节顺序是否尊重依赖关系。
-5. 标出需要移动、合并、删除或拆分的章节。
-6. 与用户确认章节顺序；未确认前不要重写全文。
-
-## 边界
-
-- 不直接开始润色全文。
-- 不改变用户核心主张。
-
-## 完成准则
-
-- `edit-plan.md` 已记录章节、主观点、依赖关系和推荐顺序
-- 用户已确认编辑计划，或明确指出要调整的章节
-- `edit-plan.md` 无残留 `[TODO:]`

package/template/workflows/doc/E-edit-article/edit-article-rewrite.md

@@ -1,31 +0,0 @@
-# Section Rewrite Phase
-
-## 输入
-
-- `speculo/.speculo/doc/<change>/edit-plan.md`
-- 用户确认后的章节顺序
-- 原始草稿
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/edited-article.md`，由 `../_templates/edit-article-template.md` 填写
-
-## 填写引导
-
-1. 按确认后的章节顺序逐节编辑。
-2. 重写每节以提升清晰度、连贯性和流畅度。
-3. 每段最多 240 个字符；超过时拆段。
-4. 保留必要的术语、代码实体、引用和用户明确要求保留的句子。
-5. 若某节依赖前文未解释的信息，调整顺序或补最小必要上下文。
-6. 每完成一节，允许用户审阅并要求局部修改。
-
-## 边界
-
-- 不新增用户没有授权的新论点。
-- 不把文章改成另一种发布平台格式，除非用户明确要求。
-
-## 完成准则
-
-- 已按 `edit-plan.md` 完成所有确认章节
-- `.status.json` 的 `edit_status` 已更新
-- `edited-article.md` 无残留 `[TODO:]`

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

@@ -1,80 +0,0 @@
----
-id: doc/writing-fragments
-category: doc
-name: Writing Fragments
-description: 通过追问式访谈采集异质写作素材，并追加到当前 doc change 的 fragments 文档
-keywords: [fragments, ideate, raw material, writing, 写作素材]
----
-
-# Writing Fragments 工作流执行指引
-
-本工作流用于在强加结构之前发展想法。它围绕用户想写的主题持续追问，捕捉 fragment，并把素材追加到当前 doc change 的 `fragments.md`。
-
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-collect-ideas`）。产物写入 `speculo/.speculo/doc/<change>/`。
-
-## 内置指引
-
-### 何时使用
-
-当用户想发展想法、采集写作原材料，或提到 `fragments`、`ideate`、`raw material`、素材、片段时使用。
-
-### 输入
-
-- 用户给出的主题、初始 prompt 或已有素材
-- 用户在会话中补充的主张、小场景、锋利句子、半成形想法
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-collect-ideas`）
-
-### 输出
-
-- `speculo/.speculo/doc/<change>/fragments.md`
-- `speculo/.speculo/doc/<change>/interview-log.md`
-- 可继续用于 `../B-writing-beats/B-writing-beats.md` 或 `../S-writing-shape/S-writing-shape.md` 的素材堆
-
-### 执行原则
-
-从用户说的第一句话开始捕捉 fragment，包括初始 prompt。不要强加阶段、提纲或结构；本 workflow 的目标是让素材变多、变锋利，而不是过早排序。
-
-fragment 是任何可能保留到最终文章中的文字片段。它必须能被作者读懂，但不需要让陌生读者立刻看懂。判断标准是“这是不是一段好文字”，不是“这是不是一个自洽论证”。
-
-第一次写入 `fragments.md` 时，在顶部放一个 H1 作为工作标题；除此之外不要放 metadata、TOC 或日期。fragments 之间用水平分隔线分隔。正文内部不要标题、标签或人为顺序。
-
-每次写入前都重新读取 `fragments.md`，保留用户在会话期间做的编辑。不要覆盖文件；只追加，除非用户明确要求原地编辑、删除或合并某个 fragment。
-
-## 阶段
-
-### 1. Fragment Interview — 追问式采集
-- 规范：`writing-fragments-interview.md`
-- 模板：`../_templates/writing-fragments-template.md`
-- 产物：`fragments.md`
-- 完成准则：
-  - 已把本轮出现的可保留 fragment 追加到 `fragments.md`
-  - `fragments.md` 无残留 `[TODO:]`
-
-### 2. Interview Log — 采集状态记录
-- 规范：`writing-fragments-log.md`
-- 模板：`../_templates/writing-interview-log-template.md`
-- 产物：`interview-log.md`
-- 完成准则：
-  - 已记录追问方向、已采集素材类型和下一轮高价值问题
-  - `interview-log.md` 无残留 `[TODO:]`
-
-## 依赖
-
-- 软依赖：无
-- 硬依赖：无
-
-## 状态扩展字段
-
-本工作流需在同 change 的 `.status.json` 追加：
-
-- `doc_entry` (string) — 固定为 `doc/F`
-- `source_material_paths` (array) — 用户提供或本 workflow 读取的素材路径
-- `document_paths` (array) — 至少包含 `fragments.md`
-- `fragment_count` (number) — 当前已采集 fragment 数量
-- `writing_status` (collecting | paused | completed | blocked) — 素材采集状态
-
-## 完成与状态更新
-
-- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
-- 每次追加 fragment 后更新 `updated_at`、`document_paths` 和 `fragment_count`。
-- 本 workflow 完成后不自动完成 change；默认可继续移交 `../B-writing-beats/B-writing-beats.md`、`../S-writing-shape/S-writing-shape.md` 或按用户要求停止。

package/template/workflows/doc/F-writing-fragments/writing-fragments-interview.md

@@ -1,32 +0,0 @@
-# Fragment Interview Phase
-
-## 输入
-
-- 用户的主题、初始 prompt 或已有素材
-- `speculo/.speculo/doc/<change>/fragments.md` 的当前内容；若不存在，按模板创建
-- 当前对话中出现的主张、小场景、锋利句子、半成形想法、引用或观察
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/fragments.md`，由 `../_templates/writing-fragments-template.md` 填写或追加
-
-## 填写引导
-
-1. 如果 `fragments.md` 不存在，先创建 H1 工作标题。
-2. 持续追问用户“你到底注意到了什么”，不要强加提纲、阶段或文章结构。
-3. 任一方产生可保留 fragment 时，先重新读取 `fragments.md`，再追加到文件末尾。
-4. fragment 之间使用独立的 `---` 分隔。
-5. fragment 可以是句子、段落、列表、代码、引用或一组相关观察，以素材自然形态为准。
-6. 用户要求“删掉最后一个”“改得更锋利”“合并那两个”时，按具体 fragment 原地编辑，其他内容保持不变。
-
-## 边界
-
-- 不塑造文章结构。
-- 不添加 metadata、TOC、日期、标签。
-- 不为了保存每个 fragment 反复询问许可。
-
-## 完成准则
-
-- 本轮值得保留的 fragment 已写入 `fragments.md`
-- 写入前已重新读取文件并保留用户编辑
-- `fragments.md` 无残留 `[TODO:]`

package/template/workflows/doc/F-writing-fragments/writing-fragments-log.md

@@ -1,29 +0,0 @@
-# Interview Log Phase
-
-## 输入
-
-- `speculo/.speculo/doc/<change>/fragments.md`
-- 本轮访谈对话
-- 用户明确指出的删除、重写、合并或保留偏好
-
-## 产物
-
-- `speculo/.speculo/doc/<change>/interview-log.md`，由 `../_templates/writing-interview-log-template.md` 填写
-
-## 填写引导
-
-1. 记录本轮追问方向，不要把 log 写成文章提纲。
-2. 标出已采集 fragment 的类型：主张、小场景、锋利句子、半成形想法、引用、观察组等。
-3. 标出下一轮最值得追问的 1-3 个方向。
-4. 记录用户对语气、删改、保留的偏好。
-
-## 边界
-
-- 不重排 `fragments.md`。
-- 不替用户决定最终文章结构。
-
-## 完成准则
-
-- `interview-log.md` 能让下一次会话继续访谈
-- 已更新 `.status.json` 的 `fragment_count` 和 `writing_status`
-- `interview-log.md` 无残留 `[TODO:]`

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

@@ -1,81 +0,0 @@
----
-id: doc/writing-shape
-category: doc
-name: Writing Shape
-description: 读取原始素材 Markdown，并通过对话式会话塑造成可发布文章
-keywords: [shape, article, markdown, draft, writing, 塑形]
----
-
-# Writing Shape 工作流执行指引
-
-本工作流用于把一份原始素材 Markdown 文件塑造成独立文章。素材堆只读；文章产物默认写入当前 doc change 的 `article.md`。
-
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-shape-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
-
-## 内置指引
-
-### 何时使用
-
-当用户有一堆笔记、fragments 或粗稿，并想把它变成可发布内容时使用。
-
-### 输入
-
-- 用户提供的原始素材 Markdown 路径，或 `speculo/.speculo/doc/<change>/fragments.md`
-- 当前文章文件：默认 `speculo/.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-shape-article`）
-
-### 输出
-
-- `speculo/.speculo/doc/<change>/article.md`
-- `speculo/.speculo/doc/<change>/shape-log.md`
-- 已确认的开头、论点顺序、格式选择和缺口
-
-### 执行原则
-
-先从头到尾读完素材堆，再做其他事。不要编辑原始素材文件，它对本 workflow 是只读的。
-
-这是反向的追问式会话：问题不是“你注意到了什么”，而是“这篇文章到底在论证什么，读者需要按什么顺序听到它”。要反驳虚弱的转场；如果一段话没有赢得自己的位置，就删掉它。
-
-每个块达成一致后立即追加到 `article.md`。每次写入前都重新读取文章文件，保留用户编辑。
-
-## 阶段
-
-### 1. Opening Choice — 候选开头
-- 规范：`writing-shape-opening.md`
-- 模板：`../_templates/writing-shape-log-template.md`
-- 产物：`shape-log.md`
-- 完成准则：
-  - 已完整读取素材
-  - 已展示 2-3 个候选开头
-  - 用户已选择或组合出开头
-
-### 2. Block Shaping — 逐块塑形
-- 规范：`writing-shape-block.md`
-- 模板：`../_templates/writing-article-template.md`
-- 产物：`article.md`
-- 完成准则：
-  - 每个写入块都有明确功能和格式选择
-  - 写入前已重新读取 `article.md`
-  - `article.md` 无残留 `[TODO:]`
-
-## 依赖
-
-- 软依赖：`../F-writing-fragments/F-writing-fragments.md`，scope: same-change
-- 硬依赖：无；用户也可以直接提供素材文件
-
-## 状态扩展字段
-
-本工作流需在同 change 的 `.status.json` 追加：
-
-- `doc_entry` (string) — 固定为 `doc/S`
-- `source_material_paths` (array) — 只读素材来源路径
-- `document_paths` (array) — 至少包含 `article.md` 和 `shape-log.md`
-- `opening_status` (unselected | selected | revised) — 开头状态
-- `format_decisions` (array) — prose、list、table、callout、quote、code 等格式选择记录
-- `writing_status` (shaping | revising | completed | blocked) — 文章塑形状态
-
-## 完成与状态更新
-
-- 进入每个 phase 时更新 `current_phase` 和 `phase_history`。
-- 每次写入块后更新 `format_decisions`、`writing_status` 和 `updated_at`。
-- 文章完成由用户决定；用户确认完成后，调用 `../../commands/archive.md` 归档 change；不得自行写入 `change_status: completed`。