@namewta/speculo 0.2.16 → 0.3.1

package/README.md

@@ -73,8 +73,7 @@ Every workflow ships an `INDEX.md` as its auto-generated work catalog. Work entr
 
 - [AGENTS.md](./AGENTS.md) — AI agent handbook (authoritative)
 - [CHANGELOG.md](./CHANGELOG.md) — Release history
-- [docs/](./docs/) — Authoring contracts for commands, skills, workflows, and persistence
-- [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers
+- [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers (self-contained authoring contracts under `_shared/` and per-skill `references/`)
 - [README-ZH.md](./README-ZH.md) — 中文镜像
 
 ## Acknowledgments — Honoring Open Source Heritage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namewta/speculo",
-  "version": "0.2.16",
+  "version": "0.3.1",
   "description": "Workflow-packaged specification-driven development assets with install, update, and migration tooling.",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
     "build": "tsc -p tsconfig.json",
     "test": "node --test dist/test/*.test.js",
     "pretest": "pnpm build",
-    "validate-assets": "node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs",
+    "generate-canonical": "node scripts/generate-specdev-canonical.mjs",
+    "validate-assets": "node scripts/generate-specdev-canonical.mjs --check && node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs",
     "check": "pnpm test && pnpm validate-assets",
     "verify-bin": "node scripts/verify-bin.mjs",
     "prepack": "pnpm build",

package/template/canonical/README.md

@@ -61,7 +61,13 @@ Canonical 文档是源文件的**透明容器**——去除 Speculo 内部元数
 
 ## 生成方法
 
-按 `speculo-write-canonical` skill 的流程手动拼接：
+SpecDev 的设计、规格、Tickets、Goal Plan 和 Wayfinder canonical 使用 Node 脚本从当前模板统一生成：
+
+```bash
+pnpm generate-canonical
+```
+
+其他 canonical 按 `speculo-write-canonical` skill 的流程手动拼接：
 
 1. 读取能力源目录，识别主入口和所有被引用文件
 2. 去除所有 YAML frontmatter
@@ -86,3 +92,4 @@ Canonical 文档是源文件的**透明容器**——去除 Speculo 内部元数
 
 - **Workflow 体积**：workflow 文件较多，生成的 canonical 文档较长。这属于预期行为——自包含性优先于简洁性。
 - **跨 workflow 引用**：如果能力引用了其他 workflow 的文件，在文档开头注明建议的配套上传文件和 GitHub 仓库地址。
+- **canonical-teach.md**：源在仓库外 vendor 目录（`temp/matt-pocock-skills/.../teach/`），不在 `template/` 内，不参与与 template 源文件的同步校验。