npm - @namewta/speculo - Versions diffs - 0.1.7 → 0.1.8 - Mend

@namewta/speculo 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (399) hide show

package/{speculo → template}/workflows/dev/I-to-issues/issues-slices.md RENAMED Viewed

@@ -13,7 +13,7 @@
 ## 产物
-- `.speculo/dev/<change>/slices.md`，由 `../_templates/issues-slices-template.md` 填写
+- `speculo/.speculo/dev/<change>/slices.md`，由 `../_templates/issues-slices-template.md` 填写
 ## `slices.md` 格式规范（五段结构）

package/{speculo → template}/workflows/dev/R-review/R-review.md RENAMED Viewed

@@ -10,7 +10,7 @@ keywords: [review, diff, spec, engineering, standards, security, solid, pr, 审
 本工作流是 `dev/R` 入口，用于审查 `HEAD` 与用户提供的固定点之间的 diff。审查以**资深工程师视角**进行，结果必须分成三个**互相独立、互不掩盖**的维度，每条 finding 带严重度，最后给出整体裁决。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-review-auth-module`）。审查产物写入 `.speculo/dev/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-review-auth-module`）。审查产物写入 `speculo/.speculo/dev/<change>/`。
 ## 内置指引

package/{speculo → template}/workflows/dev/R-review/review-axes.md RENAMED Viewed

@@ -2,7 +2,7 @@
 ## 输入
-- `.speculo/dev/<change>/review-sources.md`
+- `speculo/.speculo/dev/<change>/review-sources.md`
 - `git diff <fixed-point>...HEAD`
 - spec 来源文件或 `no spec available`
 - standards 来源文件或覆盖空白说明
@@ -10,7 +10,7 @@
 ## 产物
-- `.speculo/dev/<change>/review-report.md`，由 `../_templates/review-report-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-report.md`，由 `../_templates/review-report-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/dev/R-review/review-setup.md RENAMED Viewed

@@ -4,11 +4,11 @@
 - 用户提供的 fixed point；如果缺失，先询问
 - 当前 git 仓库
-- 当前 change 目录：`.speculo/dev/<change>/`
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`
 ## 产物
-- `.speculo/dev/<change>/review-sources.md`，由 `../_templates/review-sources-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-sources.md`，由 `../_templates/review-sources-template.md` 填写
 ## 填写引导
@@ -22,12 +22,12 @@
 5. 寻找 spec 来源，顺序为：
    - commit message 中的 issue / PR 引用
    - 用户作为参数传入的路径
-   - `.speculo/dev/<change>/prd.md`、`slices.md`、`decision-log.md`
+   - `speculo/.speculo/dev/<change>/prd.md`、`slices.md`、`decision-log.md`
    - 仓库中与分支名或功能匹配的规格文档
 6. 寻找 standards 来源，常见路径包括：
-   - `.speculo/.config/RULES.md`
-   - `.speculo/.config/context/`
-   - `.speculo/.config/adr/`
+   - `speculo/.speculo/.config/RULES.md`
+   - `speculo/.speculo/.config/context/`
+   - `speculo/.speculo/.config/adr/`
    - `AGENTS.md`、`CONTRIBUTING.md`
    - `.editorconfig`、`eslint.config.*`、`biome.json`、`prettier.config.*`、`tsconfig.json`
 7. 机器强制的标准只记录来源，不重复检查工具已覆盖的内容。

package/{speculo → template}/workflows/dev/R-review/review-verdict.md RENAMED Viewed

@@ -2,12 +2,12 @@
 ## 输入
-- `.speculo/dev/<change>/review-report.md`（三维度 findings）
+- `speculo/.speculo/dev/<change>/review-report.md`（三维度 findings）
 - `.status.json` 的 `severity_summary`
 ## 产物
-- `.speculo/dev/<change>/review-verdict.md`，由 `../_templates/review-verdict-template.md` 填写
+- `speculo/.speculo/dev/<change>/review-verdict.md`，由 `../_templates/review-verdict-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/dev/_templates/completion-summary-template.md RENAMED Viewed

@@ -22,4 +22,4 @@
 ## 归档记录
-[TODO: 归档时间、源路径 → `.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]
+[TODO: 归档时间、源路径 → `speculo/.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]

package/{speculo → template}/workflows/dev/_templates/docs-sync-report-template.md RENAMED Viewed

@@ -26,4 +26,4 @@
 ## State
-[TODO: 记录 `.speculo/dev/docs-sync-state.json` 的 old/new baseline。]
+[TODO: 记录 `speculo/.speculo/dev/docs-sync-state.json` 的 old/new baseline。]

package/{speculo → template}/workflows/doc/00-INDEX.md RENAMED Viewed

@@ -8,9 +8,11 @@ keywords: [doc, writing, article, fragments, edit, 文档, 写作]
 # Doc Workflow Index
-本文件是 doc 分类的导航入口。进入时先读取 `../../.speculo/doc-status.json`，再按其中 active change 读取 `../../.speculo/doc/<change>/.status.json`，根据用户意图推荐横向 workflow。
+> ⚠️ **持久化铁律：本文件及所有 doc workflow 的全部产物，必须且只能写入 `speculo/.speculo/doc/<change>/`。绝对禁止写入项目根目录的 `.speculo/`、`temp/` 或其他任何非规范位置。**
-> **命名铁律：** 所有 change 目录必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-draft`）。不符合此格式的目录视为 `malformed`，仅汇报不自动操作。详见 `../../docs/persistence-contract.md` §0。
+本文件是 doc 分类的导航入口。进入时先读取 `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`，仅汇报不自动操作。
 ## 入口别名
@@ -25,10 +27,10 @@ keywords: [doc, writing, article, fragments, edit, 文档, 写作]
 ## 进入协议
-1. 若用户未指定 change，扫描 `../../.speculo/doc-status.json` 和 `../../.speculo/doc/*/.status.json`，列出 active changes。
+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 目录，**目录名必须为 `YYYY-MM-DD-<kebab-name>`**（使用当前日期，`<kebab-name>` 从用户意图提取），并初始化 `.status.json` 与 `../../.speculo/doc-status.json`。
+3. 若没有 active change，按用户意图创建新的 doc change 目录，**目录名必须为 `YYYY-MM-DD-<kebab-name>`**（使用当前日期，`<kebab-name>` 从用户意图提取），并初始化 `.status.json` 与 `speculo/.speculo/doc-status.json`。
 4. 推荐入口时优先使用用户显式别名；没有别名时按用户意图推荐一个横向 workflow。
 5. 执行任何 workflow 前，读取该 workflow 入口文件、阶段文件和模板。

package/{speculo → template}/workflows/doc/B-writing-beats/B-writing-beats.md RENAMED Viewed

@@ -10,7 +10,7 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 本工作流用于把文章塑造成一段由 beat 组成的旅程。用户从原始素材中选择起始 beat；执行者只写当前 beat，然后给出下一步转向选项，直到文章自然结束。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
@@ -21,13 +21,13 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 ### 输入
 - 用户提供的原始素材 Markdown 路径，或同 change 的 `fragments.md`
-- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-article-notes`）
+- 当前文章文件：默认 `speculo/.speculo/doc/<change>/article.md`
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-article-notes`）
 ### 输出
-- `.speculo/doc/<change>/article.md`
-- `.speculo/doc/<change>/beat-log.md`
+- `speculo/.speculo/doc/<change>/article.md`
+- `speculo/.speculo/doc/<change>/beat-log.md`
 - 每轮 2-3 个候选下一个 beat
 ### 执行原则

package/{speculo → template}/workflows/doc/B-writing-beats/writing-beats-append.md RENAMED Viewed

@@ -3,12 +3,12 @@
 ## 输入
 - 用户在 Beat Options 阶段选择的 beat
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/article.md`
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/article.md`
 ## 产物
-- `.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
 ## 填写引导

package/{speculo → template}/workflows/doc/B-writing-beats/writing-beats-options.md RENAMED Viewed

@@ -2,13 +2,13 @@
 ## 输入
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
-- `.speculo/doc/<change>/beat-log.md`
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
+- `speculo/.speculo/doc/<change>/beat-log.md`
 ## 产物
-- `.speculo/doc/<change>/beat-log.md`，由 `../_templates/writing-beat-options-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/beat-log.md`，由 `../_templates/writing-beat-options-template.md` 填写或追加
 ## 填写引导

package/{speculo → template}/workflows/doc/E-edit-article/E-edit-article.md RENAMED Viewed

@@ -10,7 +10,7 @@ keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
 本工作流用于编辑已有文章草稿。先按标题和信息依赖确认章节顺序，再逐节重写，提升清晰度、连贯性和流畅度。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
@@ -20,14 +20,14 @@ keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
 ### 输入
-- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
 - 用户明确的发布目标、语气偏好或约束
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-edit-article`）
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-edit-article`）
 ### 输出
-- `.speculo/doc/<change>/edit-plan.md`
-- `.speculo/doc/<change>/edited-article.md`
+- `speculo/.speculo/doc/<change>/edit-plan.md`
+- `speculo/.speculo/doc/<change>/edited-article.md`
 - 已确认的章节顺序、依赖关系和逐节编辑结果
 ### 执行原则

package/{speculo → template}/workflows/doc/E-edit-article/edit-article-plan.md RENAMED Viewed

@@ -2,12 +2,12 @@
 ## 输入
-- 用户提供的文章草稿路径，或 `.speculo/doc/<change>/article.md`
+- 用户提供的文章草稿路径，或 `speculo/.speculo/doc/<change>/article.md`
 - 用户明确的语气、长度、发布目标和不可改变的主张
 ## 产物
-- `.speculo/doc/<change>/edit-plan.md`，由 `../_templates/edit-article-plan-template.md` 填写
+- `speculo/.speculo/doc/<change>/edit-plan.md`，由 `../_templates/edit-article-plan-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/doc/E-edit-article/edit-article-rewrite.md RENAMED Viewed

@@ -2,13 +2,13 @@
 ## 输入
-- `.speculo/doc/<change>/edit-plan.md`
+- `speculo/.speculo/doc/<change>/edit-plan.md`
 - 用户确认后的章节顺序
 - 原始草稿
 ## 产物
-- `.speculo/doc/<change>/edited-article.md`，由 `../_templates/edit-article-template.md` 填写
+- `speculo/.speculo/doc/<change>/edited-article.md`，由 `../_templates/edit-article-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/doc/F-writing-fragments/F-writing-fragments.md RENAMED Viewed

@@ -10,7 +10,7 @@ keywords: [fragments, ideate, raw material, writing, 写作素材]
 本工作流用于在强加结构之前发展想法。它围绕用户想写的主题持续追问，捕捉 fragment，并把素材追加到当前 doc change 的 `fragments.md`。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-collect-ideas`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-collect-ideas`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
@@ -22,12 +22,12 @@ keywords: [fragments, ideate, raw material, writing, 写作素材]
 - 用户给出的主题、初始 prompt 或已有素材
 - 用户在会话中补充的主张、小场景、锋利句子、半成形想法
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-collect-ideas`）
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-collect-ideas`）
 ### 输出
-- `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/interview-log.md`
+- `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` 的素材堆
 ### 执行原则

package/{speculo → template}/workflows/doc/F-writing-fragments/writing-fragments-interview.md RENAMED Viewed

@@ -3,12 +3,12 @@
 ## 输入
 - 用户的主题、初始 prompt 或已有素材
-- `.speculo/doc/<change>/fragments.md` 的当前内容；若不存在，按模板创建
+- `speculo/.speculo/doc/<change>/fragments.md` 的当前内容；若不存在，按模板创建
 - 当前对话中出现的主张、小场景、锋利句子、半成形想法、引用或观察
 ## 产物
-- `.speculo/doc/<change>/fragments.md`，由 `../_templates/writing-fragments-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/fragments.md`，由 `../_templates/writing-fragments-template.md` 填写或追加
 ## 填写引导

package/{speculo → template}/workflows/doc/F-writing-fragments/writing-fragments-log.md RENAMED Viewed

@@ -2,13 +2,13 @@
 ## 输入
-- `.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/fragments.md`
 - 本轮访谈对话
 - 用户明确指出的删除、重写、合并或保留偏好
 ## 产物
-- `.speculo/doc/<change>/interview-log.md`，由 `../_templates/writing-interview-log-template.md` 填写
+- `speculo/.speculo/doc/<change>/interview-log.md`，由 `../_templates/writing-interview-log-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md RENAMED Viewed

@@ -20,7 +20,7 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 **局限**：聚焦思维方法论的迁移，不评判政治立场；涉及 1949 年后争议历史只取思维方法论侧面并标注边界。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-mao-strategy-consult`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-mao-strategy-consult`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
@@ -99,7 +99,7 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 ## 阶段
-> **产物目录：** 本工作流所有产物写入 `.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。**`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`**（例：`2026-06-12-mao-strategy-consult`）。
+> **产物目录：** 本工作流所有产物写入 `speculo/.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。**`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`**（例：`2026-06-12-mao-strategy-consult`）。
 ### 1. 激活与问诊 — Activate
 - 规范：`activate.md`
@@ -174,7 +174,7 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 - 每完成一个分析/战略/行动模块，追加对应的 `models_applied`、`frameworks_applied`、`methods_applied`。
 - 每次引用毛泽东原文时追加 `quotes_cited`。
 - 用户确认综合咨询输出后，`change_status` 置为 `completed`。
-- 如有可沉淀的方法论洞察，在用户允许时追加到 `.speculo/.config/LESSONS.md`。
+- 如有可沉淀的方法论洞察，在用户允许时追加到 `speculo/.speculo/.config/LESSONS.md`。
 ## 参考文档导航

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/activate.md RENAMED Viewed

@@ -3,11 +3,11 @@
 ## 输入
 - 用户描述的困境、问题或咨询主题
-- 当前 doc change 目录：`.speculo/doc/<change>/`
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`
 ## 产物
-- `.speculo/doc/<change>/problem-statement.md`
+- `speculo/.speculo/doc/<change>/problem-statement.md`
 ## 填写引导

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/books/README.md RENAMED Viewed

@@ -1,5 +1,3 @@
-本文档使用mdbook构建，[点此阅读](https://weiyinfu.cn/MaoZeDongAnthology/)
 # 第一卷 国内革命战争时期
 ## 第一次国内革命战争时期
 * [000-中国社会各阶级的分析](./src/000-中国社会各阶级的分析.md)

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/deliver.md RENAMED Viewed

@@ -2,14 +2,14 @@
 ## 输入
-- `.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
-- `.speculo/doc/<change>/analysis.md`（Phase 2 产物）
-- `.speculo/doc/<change>/strategy.md`（Phase 3 产物）
-- `.speculo/doc/<change>/action-plan.md`（Phase 4 产物）
+- `speculo/.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
+- `speculo/.speculo/doc/<change>/analysis.md`（Phase 2 产物）
+- `speculo/.speculo/doc/<change>/strategy.md`（Phase 3 产物）
+- `speculo/.speculo/doc/<change>/action-plan.md`（Phase 4 产物）
 ## 产物
-- `.speculo/doc/<change>/consultation-output.md`（由模板 `../_templates/mao-consultation-output-template.md` 填写）
+- `speculo/.speculo/doc/<change>/consultation-output.md`（由模板 `../_templates/mao-consultation-output-template.md` 填写）
 ## 填写引导

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/diagnose.md RENAMED Viewed

@@ -2,12 +2,12 @@
 ## 输入
-- `.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
+- `speculo/.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
 - Module A 的 8 大分析模型（见下方）
 ## 产物
-- `.speculo/doc/<change>/analysis.md`
+- `speculo/.speculo/doc/<change>/analysis.md`
 ## 认知主线

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/mobilize.md RENAMED Viewed

@@ -2,13 +2,13 @@
 ## 输入
-- `.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
-- `.speculo/doc/<change>/analysis.md`（Phase 2 产物）
-- `.speculo/doc/<change>/strategy.md`（Phase 3 产物）
+- `speculo/.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
+- `speculo/.speculo/doc/<change>/analysis.md`（Phase 2 产物）
+- `speculo/.speculo/doc/<change>/strategy.md`（Phase 3 产物）
 ## 产物
-- `.speculo/doc/<change>/action-plan.md`
+- `speculo/.speculo/doc/<change>/action-plan.md`
 ## 核心命题

package/{speculo → template}/workflows/doc/M-mao-zedong-cognitive-os/strategize.md RENAMED Viewed

@@ -2,12 +2,12 @@
 ## 输入
-- `.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
-- `.speculo/doc/<change>/analysis.md`（Phase 2 产物）
+- `speculo/.speculo/doc/<change>/problem-statement.md`（Phase 1 产物）
+- `speculo/.speculo/doc/<change>/analysis.md`（Phase 2 产物）
 ## 产物
-- `.speculo/doc/<change>/strategy.md`
+- `speculo/.speculo/doc/<change>/strategy.md`
 ## 元框架（战略流水线）

package/{speculo → template}/workflows/doc/S-writing-shape/S-writing-shape.md RENAMED Viewed

@@ -10,7 +10,7 @@ keywords: [shape, article, markdown, draft, writing, 塑形]
 本工作流用于把一份原始素材 Markdown 文件塑造成独立文章。素材堆只读；文章产物默认写入当前 doc change 的 `article.md`。
-> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-shape-article`）。产物写入 `.speculo/doc/<change>/`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-shape-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
@@ -20,14 +20,14 @@ keywords: [shape, article, markdown, draft, writing, 塑形]
 ### 输入
-- 用户提供的原始素材 Markdown 路径，或 `.speculo/doc/<change>/fragments.md`
-- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`.speculo/doc/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-shape-article`）
+- 用户提供的原始素材 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/doc/<change>/article.md`
-- `.speculo/doc/<change>/shape-log.md`
+- `speculo/.speculo/doc/<change>/article.md`
+- `speculo/.speculo/doc/<change>/shape-log.md`
 - 已确认的开头、论点顺序、格式选择和缺口
 ### 执行原则

package/{speculo → template}/workflows/doc/S-writing-shape/writing-shape-block.md RENAMED Viewed

@@ -3,12 +3,12 @@
 ## 输入
 - 用户选定的开头与当前文章
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/shape-log.md`
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/shape-log.md`
 ## 产物
-- `.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/article.md`，由 `../_templates/writing-article-template.md` 填写或追加
 ## 填写引导

package/{speculo → template}/workflows/doc/S-writing-shape/writing-shape-opening.md RENAMED Viewed

@@ -2,12 +2,12 @@
 ## 输入
-- 原始素材 Markdown，或 `.speculo/doc/<change>/fragments.md`
-- `.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
+- 原始素材 Markdown，或 `speculo/.speculo/doc/<change>/fragments.md`
+- `speculo/.speculo/doc/<change>/article.md` 的当前内容；如果不存在，视为空文章
 ## 产物
-- `.speculo/doc/<change>/shape-log.md`，由 `../_templates/writing-shape-log-template.md` 填写或追加
+- `speculo/.speculo/doc/<change>/shape-log.md`，由 `../_templates/writing-shape-log-template.md` 填写或追加
 ## 填写引导

package/{speculo → template}/workflows/doc/T-teach/T-teach.md RENAMED Viewed

@@ -40,7 +40,7 @@ keywords: [teach, lesson, learning, glossary, 教学, 课程, 术语, 学习]
 ### Lesson 铁律
-一节 lesson 是自包含的单个 HTML 文件，保存为 `.speculo/doc/<change>/lessons/<编号>.html`。它必须：
+一节 lesson 是自包含的单个 HTML 文件，保存为 `speculo/.speculo/doc/<change>/lessons/<编号>.html`。它必须：
 - **漂亮** — 干净、可读的排版和布局，用户以后会回来复习
 - **短** — 在几分钟内可完成
@@ -76,7 +76,7 @@ keywords: [teach, lesson, learning, glossary, 教学, 课程, 术语, 学习]
 ## 阶段
-> **产物目录：** 本工作流所有产物写入 `.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。**`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`**（例：`2026-06-12-teach-react-basics`）。
+> **产物目录：** 本工作流所有产物写入 `speculo/.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。**`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`**（例：`2026-06-12-teach-react-basics`）。
 ### 1. Mission Setup — 确立学习使命
 - 规范：`teach-mission.md`
@@ -143,5 +143,5 @@ keywords: [teach, lesson, learning, glossary, 教学, 课程, 术语, 学习]
 - Phase 3-4 为循环：每次完成一节课程和收尾后，更新 `lesson_count`、`reference_count`、`glossary_term_count`。
 - 每次捕捉到学习洞察时追加 `learning_record_count`。
 - 用户声明学习目标全部达成后，可把 `change_status` 置为 `completed`。
-- 如有可沉淀教学经验，在用户允许时追加到 `.speculo/.config/LESSONS.md`。
+- 如有可沉淀教学经验，在用户允许时追加到 `speculo/.speculo/.config/LESSONS.md`。
 - NOTES.md 作为教学偏好暂存区，AI 在后续课程设计中应参考其中记录。

package/{speculo → template}/workflows/doc/T-teach/teach-lesson-wrap.md RENAMED Viewed

@@ -4,17 +4,17 @@
 ## 输入
-- `.speculo/doc/<change>/lessons/<编号>.html` — 刚完成的课程
-- `.speculo/doc/<change>/GLOSSARY.md` — 已有术语表（若不存在则创建）
-- `.speculo/doc/<change>/learning-records/` — 已有学习记录
-- `.speculo/doc/<change>/NOTES.md` — 用户教学偏好
+- `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/doc/<change>/reference/<编号>.html` — 本节课程的压缩参考文档
-- `.speculo/doc/<change>/GLOSSARY.md` — 更新后的术语表
-- `.speculo/doc/<change>/learning-records/<编号>.md` — 可选，仅当产生了非显而易见的洞察
-- `.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` — 可选，仅当用户表达了新的教学偏好
 ## 填写引导

package/{speculo → template}/workflows/doc/T-teach/teach-lesson.md RENAMED Viewed

@@ -4,16 +4,16 @@
 ## 输入
-- `.speculo/doc/<change>/mission.md` — 教学使命
-- `.speculo/doc/<change>/resources.md` — 可信资源
-- `.speculo/doc/<change>/GLOSSARY.md` — 已有术语（若存在）
-- `.speculo/doc/<change>/learning-records/` — 已有学习记录
-- `.speculo/doc/<change>/NOTES.md` — 用户教学偏好（若存在）
-- `.speculo/doc/<change>/lessons/` — 已有课程（判断最近发展区）
+- `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/doc/<change>/lessons/<编号>.html`，按 `T-teach.md` 内置指引中的课程结构模板创建
+- `speculo/.speculo/doc/<change>/lessons/<编号>.html`，按 `T-teach.md` 内置指引中的课程结构模板创建
 - 编号规则：扫描 `lessons/` 下已有最高编号 +1，起始 `0001`
 ## 填写引导

package/{speculo → template}/workflows/doc/T-teach/teach-mission.md RENAMED Viewed

@@ -4,11 +4,11 @@
 - 用户声明的学习主题或模糊兴趣
 - 用户对「为什么想学这个」的任何初始表述
-- 当前 doc change 目录：`.speculo/doc/<change>/`
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`
 ## 产物
-- `.speculo/doc/<change>/mission.md`，由 `../_templates/teach-mission-template.md` 填写
+- `speculo/.speculo/doc/<change>/mission.md`，由 `../_templates/teach-mission-template.md` 填写
 ## 填写引导

package/{speculo → template}/workflows/doc/T-teach/teach-resources.md RENAMED Viewed

@@ -2,13 +2,13 @@
 ## 输入
-- `.speculo/doc/<change>/mission.md`（已确认的使命）
+- `speculo/.speculo/doc/<change>/mission.md`（已确认的使命）
 - 用户的社区偏好（是否愿意加入线上/线下社区）
-- 当前 doc change 目录：`.speculo/doc/<change>/`
+- 当前 doc change 目录：`speculo/.speculo/doc/<change>/`
 ## 产物
-- `.speculo/doc/<change>/resources.md`，由 `../_templates/teach-resources-template.md` 填写
+- `speculo/.speculo/doc/<change>/resources.md`，由 `../_templates/teach-resources-template.md` 填写
 ## 填写引导