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

@namewta/speculo 0.1.6 → 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 (401) hide show

package/{speculo → template}/workflows/dev/D-docs-sync/state-json-schema.md RENAMED Viewed

@@ -1,6 +1,6 @@
 # state 文件 Schema（docs-sync 持久化状态）
-**默认存储位置**：`.speculo/dev/docs-sync-state.json`
+**默认存储位置**：`speculo/.speculo/dev/docs-sync-state.json`
 本 workflow 在首次运行时会按默认路径创建；后续读写均以同一路径为准。不要把 docs-sync state 放到仓库根目录。
@@ -9,7 +9,7 @@
 - docs-sync workflow **唯一**的跨 change 持久化状态
 - 每次成功同步后原子化写入
 - 必须跟随仓库提交到 git（作为同步基线的事实来源）
-- **不放在 workflow 资产目录内**：workflow 目录是只读知识资产，状态属于项目 `.speculo/`
+- **不放在 workflow 资产目录内**：workflow 目录是只读知识资产，状态属于项目 `speculo/.speculo/`
 **初始化模板**：`../_templates/docs-sync-state-template.json`
@@ -45,7 +45,7 @@
 {
   "schema_version": 1,
   "skill": "docs-sync",
-  "state_path": ".speculo/dev/docs-sync-state.json",
+  "state_path": "speculo/.speculo/dev/docs-sync-state.json",
   "tracked_docs": [],
   "last_sync_sha": null,
   "last_sync_short": null,
@@ -64,7 +64,7 @@
 {
   "schema_version": 1,
   "skill": "docs-sync",
-  "state_path": ".speculo/dev/docs-sync-state.json",
+  "state_path": "speculo/.speculo/dev/docs-sync-state.json",
   "tracked_docs": ["README.md", "CHANGELOG.md"],
   "last_sync_sha": "2d16d7a4d7f5da165c565b9aa3265824be133214",
   "last_sync_short": "2d16d7a",
@@ -83,7 +83,7 @@
 {
   "schema_version": 1,
   "skill": "docs-sync",
-  "state_path": ".speculo/dev/docs-sync-state.json",
+  "state_path": "speculo/.speculo/dev/docs-sync-state.json",
   "tracked_docs": ["README.md", "CHANGELOG.md"],
   "last_sync_sha": "abc1234def5678...",
   "last_sync_short": "abc1234",
@@ -102,7 +102,7 @@
 {
   "schema_version": 1,
   "skill": "docs-sync",
-  "state_path": ".speculo/dev/docs-sync-state.json",
+  "state_path": "speculo/.speculo/dev/docs-sync-state.json",
   "tracked_docs": ["README.md", "CHANGELOG.md"],
   "last_sync_sha": "ffe9876abc5432...",
   "last_sync_short": "ffe9876",
@@ -126,7 +126,7 @@
 读取 state 文件时按以下降级链处理：
-1. 文件不存在 → 首次运行流程：复制 `../_templates/docs-sync-state-template.json` 到 `.speculo/dev/docs-sync-state.json`，基线设为当前 HEAD，请用户确认 `tracked_docs`
+1. 文件不存在 → 首次运行流程：复制 `../_templates/docs-sync-state-template.json` 到 `speculo/.speculo/dev/docs-sync-state.json`，基线设为当前 HEAD，请用户确认 `tracked_docs`
 2. JSON 解析失败 → 报错退出，要求用户手动修复或删除
 3. `schema_version > 1` → 报错退出，提示技能版本过旧
 4. `last_sync_sha` 不是 40 字符十六进制且不为 `null` → 视为损坏，回退到首次运行
@@ -152,4 +152,4 @@
 - 不要手动编辑 `last_sync_sha`（除非在修复损坏状态）
 - 不要把敏感信息、机器信息、用户信息写入
 - 不要让 `total_syncs` 回退
-- 不要把 state 文件放回 workflow 资产目录——它属于项目 `.speculo/` 状态，不属于 framework 资产
+- 不要把 state 文件放回 workflow 资产目录——它属于项目 `speculo/.speculo/` 状态，不属于 framework 资产

package/{speculo → template}/workflows/dev/H-diagnose/H-diagnose.md RENAMED Viewed

@@ -19,16 +19,18 @@ keywords: [diagnose, hotfix, bug, debug, performance, 回归]
 ### 输入
 - 用户描述的失败现象、日志、复现步骤或性能症状
-- 当前 change 目录：`.speculo/dev/<change>/`
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-fix-login-bug`）
 - 可运行的测试、脚本、服务或其他反馈循环
 ### 输出
-- `.speculo/dev/<change>/diagnosis.md`
-- `.speculo/dev/<change>/regression.md`
+- `speculo/.speculo/dev/<change>/diagnosis.md`
+- `speculo/.speculo/dev/<change>/regression.md`
 - 诊断记录、假设列表、插桩结果、修复与回归验证结论
 - 若缺少可信反馈循环，输出已尝试方法和需要用户提供的材料
+（`<change>` 格式：`YYYY-MM-DD-<kebab-name>`）
 ### 执行原则
 完整诊断循环为：复现 -> 最小化 -> 假设 -> 插桩 -> 修复 -> 回归测试。仅在明确合理时才跳过阶段。

package/{speculo → template}/workflows/dev/H-diagnose/diagnose-fix.md RENAMED Viewed

@@ -10,7 +10,7 @@
 ## 产物
-- `.speculo/dev/<change>/regression.md`，由 `../_templates/regression-template.md` 填写
+- `speculo/.speculo/dev/<change>/regression.md`，由 `../_templates/regression-template.md` 填写
 ## 填写引导
@@ -25,7 +25,7 @@
 - 不提交未验证修复。
 - 不自动归档 change。
-- 不修改 `.speculo/.config/RULES.md` 或用户未明确授权的项目规则文档。
+- 不修改 `speculo/.speculo/.config/RULES.md` 或用户未明确授权的项目规则文档。
 ## 完成准则

package/{speculo → template}/workflows/dev/H-diagnose/diagnose-loop.md RENAMED Viewed

@@ -9,7 +9,7 @@
 ## 产物
-- `.speculo/dev/<change>/diagnosis.md`，由 `../_templates/diagnosis-template.md` 填写
+- `speculo/.speculo/dev/<change>/diagnosis.md`，由 `../_templates/diagnosis-template.md` 填写
 ## 填写引导

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

@@ -18,14 +18,16 @@ keywords: [issues, slices, vertical, AFK, HITL, 切片]
 - PRD、计划、设计记录、bug 诊断结论或当前对话上下文
 - 用户明确提供的 issue tracker 配置和标签词汇表（如果存在）
-- 当前 change 目录：`.speculo/dev/<change>/`
+- 当前 change 目录：`speculo/.speculo/dev/<change>/`（`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`，例：`2026-06-12-user-auth`）
 ### 输出
-- `.speculo/dev/<change>/slices.md`
+- `speculo/.speculo/dev/<change>/slices.md`
 - 垂直切片清单、依赖关系、HITL/AFK 标记和验收标准
 - 可选的外部 issue 引用
+（`<change>` 格式：`YYYY-MM-DD-<kebab-name>`）
 ### 垂直切片规则
 - 每个切片交付一条贯穿所有层（schema、API、UI、测试）的窄但完整的路径。

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,6 +10,8 @@ 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/.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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../04-finalize/04-finalize.md`
 > **产物文件名：** `completion-summary.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Completion Summary
@@ -21,4 +22,4 @@
 ## 归档记录
-[TODO: 归档时间、源路径 → `.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]
+[TODO: 归档时间、源路径 → `speculo/.speculo/archive/dev/<YYYY-MM>/<change>/`、用户确认记录。]

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../04-finalize/04-finalize.md`
 > **产物文件名：** `completion-verification.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Completion Verification

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../H-diagnose/H-diagnose.md`
 > **产物文件名：** `diagnosis.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Diagnosis

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../D-docs-sync/D-docs-sync.md`
 > **产物文件名：** `docs-sync-report.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Docs Sync Report
@@ -25,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/dev/_templates/grill-context-map-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../01-grill-with-docs/01-grill-with-docs.md`
 > **产物文件名：** `context-map.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Context Map

package/{speculo → template}/workflows/dev/_templates/grill-decision-log-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../01-grill-with-docs/01-grill-with-docs.md`
 > **产物文件名：** `decision-log.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Decision Log

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../I-to-issues/I-to-issues.md`
 > **产物文件名：** `slices.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Vertical Slices

package/{speculo → template}/workflows/dev/_templates/prd-overview-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../02-prd/02-prd.md`
 > **产物文件名：** `overview.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Overview

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../02-prd/02-prd.md`
 > **产物文件名：** `prd.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # PRD

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../H-diagnose/H-diagnose.md`
 > **产物文件名：** `regression.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Regression

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../R-review/R-review.md`
 > **产物文件名：** `review-report.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Review Report

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../R-review/R-review.md`
 > **产物文件名：** `review-sources.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Review Sources

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

@@ -1,5 +1,6 @@
 > **服务工作流：** `../R-review/R-review.md`
 > **产物文件名：** `review-verdict.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Review Verdict

package/{speculo → template}/workflows/dev/_templates/tdd-log-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../03-tdd/03-tdd.md`
 > **产物文件名：** `tdd/<phase-id>/implementation-log.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Implementation Log

package/{speculo → template}/workflows/dev/_templates/tdd-plan-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../03-tdd/03-tdd.md`
 > **产物文件名：** `tdd/<phase-id>/tdd-plan.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # TDD Plan

package/{speculo → template}/workflows/dev/_templates/tdd-verification-template.md RENAMED Viewed

@@ -1,5 +1,6 @@
 > **服务工作流：** `../03-tdd/03-tdd.md`
 > **产物文件名：** `tdd/<phase-id>/verification.md`
+> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
 # Verification

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

@@ -8,7 +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/` 或其他任何非规范位置。**
+本文件是 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`，仅汇报不自动操作。
 ## 入口别名
@@ -23,9 +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 目录，并初始化 `.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 入口文件、阶段文件和模板。
@@ -43,6 +48,7 @@ keywords: [doc, writing, article, fragments, edit, 文档, 写作]
 输出 doc 状态时至少包含：
 - active change 数量与每个 change 的 `current_phase`
+- malformed 目录清单（不符合 `YYYY-MM-DD-<kebab-name>` 格式的目录）
 - 每个 change 的当前文档路径、素材路径和最近写入时间
 - `phase_history` 最后一项为 `blocked` 或 `updated_at` 超过 14 天未变化的 change
 - 推荐下一步入口和原因

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

@@ -10,6 +10,8 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 本工作流用于把文章塑造成一段由 beat 组成的旅程。用户从原始素材中选择起始 beat；执行者只写当前 beat，然后给出下一步转向选项，直到文章自然结束。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-article-notes`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
 ### 何时使用
@@ -19,13 +21,13 @@ keywords: [beats, narrative, article, writing, 叙事, 文章]
 ### 输入
 - 用户提供的原始素材 Markdown 路径，或同 change 的 `fragments.md`
-- 当前文章文件：默认 `.speculo/doc/<change>/article.md`
-- 当前 doc change 目录：`.speculo/doc/<change>/`
+- 当前文章文件：默认 `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,6 +10,8 @@ keywords: [edit, article, revise, clarity, draft, 编辑, 修订]
 本工作流用于编辑已有文章草稿。先按标题和信息依赖确认章节顺序，再逐节重写，提升清晰度、连贯性和流畅度。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-edit-article`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
 ### 何时使用
@@ -18,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>/`
+- 当前 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,6 +10,8 @@ keywords: [fragments, ideate, raw material, writing, 写作素材]
 本工作流用于在强加结构之前发展想法。它围绕用户想写的主题持续追问，捕捉 fragment，并把素材追加到当前 doc change 的 `fragments.md`。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-collect-ideas`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
 ### 何时使用
@@ -20,12 +22,12 @@ keywords: [fragments, ideate, raw material, writing, 写作素材]
 - 用户给出的主题、初始 prompt 或已有素材
 - 用户在会话中补充的主张、小场景、锋利句子、半成形想法
-- 当前 doc change 目录：`.speculo/doc/<change>/`
+- 当前 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,6 +20,8 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 **局限**：聚焦思维方法论的迁移，不评判政治立场；涉及 1949 年后争议历史只取思维方法论侧面并标注边界。
+> **目录命名：** `<change>` 必须为 `YYYY-MM-DD-<kebab-name>`（例：`2026-06-12-mao-strategy-consult`）。产物写入 `speculo/.speculo/doc/<change>/`。
 ## 内置指引
 ### 角色扮演规则
@@ -97,7 +99,7 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 ## 阶段
-> **产物目录：** 本工作流所有产物写入 `.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。
+> **产物目录：** 本工作流所有产物写入 `speculo/.speculo/doc/<change>/`。下文产物路径均相对该 change 目录。**`<change>` 必须为 `YYYY-MM-DD-<kebab-name>`**（例：`2026-06-12-mao-strategy-consult`）。
 ### 1. 激活与问诊 — Activate
 - 规范：`activate.md`
@@ -172,7 +174,7 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 - 每完成一个分析/战略/行动模块，追加对应的 `models_applied`、`frameworks_applied`、`methods_applied`。
 - 每次引用毛泽东原文时追加 `quotes_cited`。
 - 用户确认综合咨询输出后，`change_status` 置为 `completed`。
-- 如有可沉淀的方法论洞察，在用户允许时追加到 `.speculo/.config/LESSONS.md`。
+- 如有可沉淀的方法论洞察，在用户允许时追加到 `speculo/.speculo/.config/LESSONS.md`。
 ## 参考文档导航
@@ -187,12 +189,12 @@ keywords: [毛泽东, 毛选, 教员, 矛盾分析, 战略, 组织, 认知模型
 | 表达风格要全量句式/比喻库/范式 | `references/research/14-voice-and-dialogue.md` |
 | 要引用原文金句、查篇目编号映射 | `references/research/15-quote-bank.md` |
-## 外挂知识库（可选）
+## 内置知识库
-本工作流可挂载《毛泽东选集》全文数字化版本（开源库 [weiyinfu/MaoZeDongAnthology](https://github.com/weiyinfu/MaoZeDongAnthology)），用于检索原文、精确引用。
+本工作流内置《毛泽东选集》全文数字化版本（229 篇，编号 000–228），位于工作流目录下的 `books/`，无需联网即可检索原文、精确引用。
-**路径发现**（按序尝试）：环境变量 `$MAOXUAN_KB_PATH` → `~/MaoZeDongAnthology/` → `./MaoZeDongAnthology/` → `../MaoZeDongAnthology/`。均未命中则静默跳过，仅用内置框架。
+**知识库路径**：`./books/`（即本工作流目录下的 `books/` 子目录）。
-**知识库结构**：文章原文 `src/NNN-标题.md`（229 篇，编号 000–228），层级目录 `src/目录.md`。
+**知识库结构**：文章原文 `books/src/NNN-标题.md`（229 篇，编号 000–228），层级目录 `books/src/目录.md`，卷次索引 `books/README.md`。
 **引用纪律**：引金句必带篇目名与编号；区分逐字原文（加引号）与概括转述（标注"转述/大意"）；建国后争议文本只引方法论句并附边界提示。