@namewta/speculo 0.1.0

package/speculo/workflows/doc/00-INDEX.md

@@ -0,0 +1,51 @@
+---
+id: doc/index
+category: doc
+name: Doc Workflow Index
+description: 文档写作、塑形、编辑与素材管理的横向工作流导航入口
+keywords: [doc, writing, article, fragments, edit, 文档, 写作]
+---
+
+# Doc Workflow Index
+
+本文件是 doc 分类的导航入口。进入时先读取 `../../.speculo/doc-status.json`，再按其中 active change 读取 `../../.speculo/doc/<change>/.status.json`，根据用户意图推荐横向 workflow。
+
+## 入口别名
+
+| 别名 | 入口 | 用途 |
+|------|------|------|
+| `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/doc-status.json` 和 `../../.speculo/doc/*/.status.json`，列出 active changes。
+2. 若只有一个 active change，默认继续该 change；若有多个 active change，要求用户选择。
+3. 若没有 active change，按用户意图创建新的 doc change 目录，并初始化 `.status.json` 与 `../../.speculo/doc-status.json`。
+4. 推荐入口时优先使用用户显式别名；没有别名时按用户意图推荐一个横向 workflow。
+5. 执行任何 workflow 前，读取该 workflow 入口文件、阶段文件和模板。
+
+## 执行模式
+
+- `fragments`：从主题和对话中采集素材，进入 `doc/F`。
+- `beats`：已有素材，想逐个转向推进叙事，进入 `doc/B`。
+- `shape`：已有素材堆或粗稿，想塑造成可发布文章，进入 `doc/S`。
+- `edit`：已有文章草稿，想编辑、重组、润色，进入 `doc/E`。
+
+## 状态汇报
+
+输出 doc 状态时至少包含：
+
+- active change 数量与每个 change 的 `current_phase`
+- 每个 change 的当前文档路径、素材路径和最近写入时间
+- `phase_history` 最后一项为 `blocked` 或 `updated_at` 超过 14 天未变化的 change
+- 推荐下一步入口和原因
+
+## 完成与状态更新
+
+- 所有 doc workflow 必须维护同一 change 的 `.status.json`。
+- 进入 phase 时更新 `current_phase`，并在 `phase_history` 追加 `in-progress` 记录。
+- phase 完成时写入 `completed_at` 和 `status: completed`。
+- 用户确认文章、素材采集或编辑边界完成后，才把 `change_status` 置为 `completed`。

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

@@ -0,0 +1,77 @@
+---
+id: doc/writing-beats
+category: doc
+name: Writing Beats
+description: 从素材堆中选择起始 beat，并逐个 beat 推进文章旅程
+keywords: [beats, narrative, article, writing, 叙事, 文章]
+---
+
+# Writing Beats 工作流执行指引
+
+本工作流用于把文章塑造成一段由 beat 组成的旅程。用户从原始素材中选择起始 beat；执行者只写当前 beat，然后给出下一步转向选项，直到文章自然结束。
+
+## 内置指引
+
+### 何时使用
+
+当用户已有原始素材，并想把它组织成叙事旅程而不是一次性论证时使用。
+
+### 输入
+
+- 用户提供的原始素材 Markdown 路径，或同 change 的 `fragments.md`
+- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
+- 当前 doc change 目录：`.speculo/doc/<change>/`
+
+### 输出
+
+- `.speculo/doc/<change>/article.md`
+- `.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`。
+- 文章自然结束且用户确认后，可把 `change_status` 置为 `completed`。

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

@@ -0,0 +1,31 @@
+# Beat Append Phase
+
+## 输入
+
+- 用户在 Beat Options 阶段选择的 beat
+- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
+- `.speculo/doc/<change>/article.md`
+
+## 产物
+
+- `.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/speculo/workflows/doc/B-writing-beats/writing-beats-options.md

@@ -0,0 +1,29 @@
+# Beat Options Phase
+
+## 输入
+
+- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
+- `.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
+- `.speculo/doc/<change>/beat-log.md`
+
+## 产物
+
+- `.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/speculo/workflows/doc/E-edit-article/E-edit-article.md

@@ -0,0 +1,77 @@
+---
+id: doc/edit-article
+category: doc
+name: Edit Article
+description: 通过重组章节、提升清晰度、收紧表达来编辑和改进文章草稿
+keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
+---
+
+# Edit Article 工作流执行指引
+
+本工作流用于编辑已有文章草稿。先按标题和信息依赖确认章节顺序，再逐节重写，提升清晰度、连贯性和流畅度。
+
+## 内置指引
+
+### 何时使用
+
+当用户想编辑、修订、改进文章草稿，或要求重组章节、收紧表达、提升清晰度时使用。
+
+### 输入
+
+- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户明确的发布目标、语气偏好或约束
+- 当前 doc change 目录：`.speculo/doc/<change>/`
+
+### 输出
+
+- `.speculo/doc/<change>/edit-plan.md`
+- `.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 完成后，可把 `change_status` 置为 `completed`。

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

@@ -0,0 +1,30 @@
+# Edit Plan Phase
+
+## 输入
+
+- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户明确的语气、长度、发布目标和不可改变的主张
+
+## 产物
+
+- `.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/speculo/workflows/doc/E-edit-article/edit-article-rewrite.md

@@ -0,0 +1,31 @@
+# Section Rewrite Phase
+
+## 输入
+
+- `.speculo/doc/<change>/edit-plan.md`
+- 用户确认后的章节顺序
+- 原始草稿
+
+## 产物
+
+- `.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/speculo/workflows/doc/F-writing-fragments/F-writing-fragments.md

@@ -0,0 +1,78 @@
+---
+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`。
+
+## 内置指引
+
+### 何时使用
+
+当用户想发展想法、采集写作原材料，或提到 `fragments`、`ideate`、`raw material`、素材、片段时使用。
+
+### 输入
+
+- 用户给出的主题、初始 prompt 或已有素材
+- 用户在会话中补充的主张、小场景、锋利句子、半成形想法
+- 当前 doc change 目录：`.speculo/doc/<change>/`
+
+### 输出
+
+- `.speculo/doc/<change>/fragments.md`
+- `.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/speculo/workflows/doc/F-writing-fragments/writing-fragments-interview.md

@@ -0,0 +1,32 @@
+# Fragment Interview Phase
+
+## 输入
+
+- 用户的主题、初始 prompt 或已有素材
+- `.speculo/doc/<change>/fragments.md` 的当前内容；若不存在，按模板创建
+- 当前对话中出现的主张、小场景、锋利句子、半成形想法、引用或观察
+
+## 产物
+
+- `.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/speculo/workflows/doc/F-writing-fragments/writing-fragments-log.md

@@ -0,0 +1,29 @@
+# Interview Log Phase
+
+## 输入
+
+- `.speculo/doc/<change>/fragments.md`
+- 本轮访谈对话
+- 用户明确指出的删除、重写、合并或保留偏好
+
+## 产物
+
+- `.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/speculo/workflows/doc/S-writing-shape/S-writing-shape.md

@@ -0,0 +1,79 @@
+---
+id: doc/writing-shape
+category: doc
+name: Writing Shape
+description: 读取原始素材 Markdown，并通过对话式会话塑造成可发布文章
+keywords: [shape, article, markdown, draft, writing, 塑形]
+---
+
+# Writing Shape 工作流执行指引
+
+本工作流用于把一份原始素材 Markdown 文件塑造成独立文章。素材堆只读；文章产物默认写入当前 doc change 的 `article.md`。
+
+## 内置指引
+
+### 何时使用
+
+当用户有一堆笔记、fragments 或粗稿，并想把它变成可发布内容时使用。
+
+### 输入
+
+- 用户提供的原始素材 Markdown 路径，或 `.speculo/doc/<change>/fragments.md`
+- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
+- 当前 doc change 目录：`.speculo/doc/<change>/`
+
+### 输出
+
+- `.speculo/doc/<change>/article.md`
+- `.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`。
+- 文章完成由用户决定；用户确认完成后，可把 `change_status` 置为 `completed`。

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

@@ -0,0 +1,32 @@
+# Block Shaping Phase
+
+## 输入
+
+- 用户选定的开头与当前文章
+- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
+- `.speculo/doc/<change>/shape-log.md`
+
+## 产物
+
+- `.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/speculo/workflows/doc/S-writing-shape/writing-shape-opening.md

@@ -0,0 +1,27 @@
+# Opening Choice Phase
+
+## 输入
+
+- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
+- `.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
+
+## 产物
+
+- `.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/speculo/workflows/doc/_templates/edit-article-plan-template.md

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

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

@@ -0,0 +1,6 @@
+> **服务工作流：** `../E-edit-article/E-edit-article.md`
+> **产物文件名：** `edited-article.md`
+
+# [TODO: 编辑后文章标题]
+
+[TODO: 按确认后的章节顺序写入编辑后正文。每段默认不超过 240 个字符。]

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

@@ -0,0 +1,6 @@
+> **服务工作流：** `../B-writing-beats/B-writing-beats.md` 或 `../S-writing-shape/S-writing-shape.md`
+> **产物文件名：** `article.md`
+
+# [TODO: 文章标题]
+
+[TODO: 文章正文。由 workflow 每次只追加一个 beat 或一个确认后的内容块。]

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

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