@namewta/speculo 1.0.1 → 1.0.2

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 (79) hide show
  1. package/README.md +3 -2
  2. package/package.json +2 -2
  3. package/template/AGENTS.md +12 -1
  4. package/template/canonical/canonical-specdev-goal-plan.md +10 -1
  5. package/template/canonical/canonical-specdev-grill-with-docs.md +7 -0
  6. package/template/canonical/canonical-specdev-orchestrate-implementation.md +18 -2
  7. package/template/canonical/canonical-specdev-spec.md +7 -0
  8. package/template/canonical/canonical-specdev-tickets.md +13 -6
  9. package/template/canonical/canonical-specdev-wayfinder.md +7 -0
  10. package/template/commands/archive-and-consolidate.md +1 -2
  11. package/template/commands/docs-sync.md +1 -1
  12. package/template/commands/git-repository-audit.md +1 -1
  13. package/template/commands/handoff.md +1 -1
  14. package/template/commands/retro.md +1 -1
  15. package/template/commands/status.md +1 -1
  16. package/template/skills/archive-and-consolidate/SKILL.md +9 -168
  17. package/template/skills/archive-and-consolidate/references/entry-procedure.md +170 -0
  18. package/template/skills/docs-sync/SKILL.md +9 -11
  19. package/template/skills/docs-sync/references/entry-procedure.md +18 -0
  20. package/template/skills/engineering-standards-builder/SKILL.md +9 -148
  21. package/template/skills/engineering-standards-builder/references/entry-procedure.md +154 -0
  22. package/template/skills/git-history-squash/SKILL.md +9 -88
  23. package/template/skills/git-history-squash/references/entry-procedure.md +94 -0
  24. package/template/skills/github-npm-ops/SKILL.md +9 -18
  25. package/template/skills/github-npm-ops/references/entry-procedure.md +25 -0
  26. package/template/skills/optimize-codex-config/SKILL.md +12 -72
  27. package/template/skills/optimize-codex-config/references/entry-procedure.md +78 -0
  28. package/template/skills/source-code-zip/SKILL.md +10 -559
  29. package/template/skills/source-code-zip/references/entry-procedure.md +565 -0
  30. package/template/skills/speculo-retro/SKILL.md +9 -16
  31. package/template/skills/speculo-retro/references/entry-procedure.md +23 -0
  32. package/template/skills/upstream-fork-sync/SKILL.md +10 -72
  33. package/template/skills/upstream-fork-sync/references/entry-procedure.md +78 -0
  34. package/template/skills/writing-great-skills/SKILL.md +9 -73
  35. package/template/skills/writing-great-skills/references/entry-procedure.md +79 -0
  36. package/template/workflows/learning/A-archive/A-archive.md +7 -0
  37. package/template/workflows/learning/A-assess-and-plan/A-assess-and-plan.md +7 -0
  38. package/template/workflows/learning/C-consolidate/C-consolidate.md +7 -0
  39. package/template/workflows/learning/H-homework/H-homework.md +8 -1
  40. package/template/workflows/learning/I-init-setup/I-init-setup.md +7 -0
  41. package/template/workflows/learning/INDEX.md +2 -0
  42. package/template/workflows/learning/L-lesson/L-lesson.md +7 -0
  43. package/template/workflows/learning/R-review/R-review.md +8 -1
  44. package/template/workflows/learning/README.md +3 -1
  45. package/template/workflows/learning/common/rules/activation-and-memory.md +20 -0
  46. package/template/workflows/ops/A-archive-and-learn/A-archive-and-learn.md +7 -0
  47. package/template/workflows/ops/E-execute-and-stabilize/E-execute-and-stabilize.md +8 -1
  48. package/template/workflows/ops/I-intake-and-assess/I-intake-and-assess.md +7 -0
  49. package/template/workflows/ops/INDEX.md +2 -0
  50. package/template/workflows/ops/P-plan-and-approve/P-plan-and-approve.md +8 -1
  51. package/template/workflows/ops/README.md +3 -0
  52. package/template/workflows/ops/common/rules/activation-and-memory.md +20 -0
  53. package/template/workflows/person/INDEX.md +2 -0
  54. package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +9 -0
  55. package/template/workflows/person/M-mao-zedong-cognitive-os/books/README.md +1 -1
  56. package/template/workflows/person/S-steelman-deliberation/S-steelman-deliberation.md +7 -0
  57. package/template/workflows/person/common/rules/activation-and-memory.md +20 -0
  58. package/template/workflows/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md +7 -0
  59. package/template/workflows/specdev/C-code-review/C-code-review.md +7 -0
  60. package/template/workflows/specdev/D-diagnose-bugs/D-diagnose-bugs.md +7 -0
  61. package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +7 -0
  62. package/template/workflows/specdev/I-implement/I-implement.md +7 -0
  63. package/template/workflows/specdev/I-implement/execution-preflight.md +1 -1
  64. package/template/workflows/specdev/I-init-setup/I-init-setup.md +7 -0
  65. package/template/workflows/specdev/INDEX.md +2 -0
  66. package/template/workflows/specdev/L-learn-change/L-learn-change.md +7 -0
  67. package/template/workflows/specdev/O-orchestrate-implementation/O-orchestrate-implementation.md +10 -1
  68. package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +10 -1
  69. package/template/workflows/specdev/P-prototype/P-prototype.md +7 -0
  70. package/template/workflows/specdev/R-review-architecture/R-review-architecture.md +7 -0
  71. package/template/workflows/specdev/README.md +3 -0
  72. package/template/workflows/specdev/S-spec/S-spec.md +7 -0
  73. package/template/workflows/specdev/T-tickets/T-tickets.md +10 -3
  74. package/template/workflows/specdev/T-tickets/ticket-template.md +2 -2
  75. package/template/workflows/specdev/T-tickets/tickets-map-template.md +1 -1
  76. package/template/workflows/specdev/T-triage/T-triage.md +7 -0
  77. package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +7 -0
  78. package/template/workflows/specdev/common/README.md +1 -0
  79. package/template/workflows/specdev/common/rules/activation-and-memory.md +20 -0
@@ -110,6 +110,7 @@ E 为每次 deploy、remediation、rollback 或 verification-only 分配新 ATTE
110
110
  ## Common 与验证
111
111
 
112
112
  - 工件、scope、证据、target profile/发布 Gate、批准、执行循环和知识关闭规则:`<Path>{roots.workflows}/ops/common/rules/</Path>`
113
+ - 激活与记忆读取规则:`<Path>{roots.workflows}/ops/common/rules/activation-and-memory.md</Path>`
113
114
  - 状态与领域 schema:`<Path>{roots.workflows}/ops/common/schemas/</Path>`
114
115
  - 确定性验证器:`<Path>{roots.workflows}/ops/common/tools/validate-ops.mjs</Path>`
115
116
  - 摘要绑定的关闭工具:`<Path>{roots.workflows}/ops/common/tools/close-change.mjs</Path>`
@@ -118,3 +119,5 @@ E 为每次 deploy、remediation、rollback 或 verification-only 分配新 ATTE
118
119
  node <Path>{roots.workflows}/ops/common/tools/validate-ops.mjs</Path> --workflow-root <Path>{roots.workflows}/ops</Path>
119
120
  node <Path>{roots.workflows}/ops/common/tools/validate-ops.mjs</Path> --state-root <Path>{roots.state}/ops</Path>
120
121
  ```
122
+
123
+ 激活后读取 `<Path>{roots.workflows}/ops/common/rules/activation-and-memory.md</Path>`:先定位相关 entry,再回读少量原文与 provenance;正式写入前检查 owner/gateway、pending transaction、lock 和 recovery evidence。
@@ -0,0 +1,20 @@
1
+ # Activation and memory retrieval protocol
2
+
3
+ 本规则只在用户明确激活当前 workflow 或某个 Work 后读取。INDEX 只用于被动发现,不初始化状态、不读取 active change、不写入知识。
4
+
5
+ ## Locate before read
6
+
7
+ 1. 先解析当前 workflow 的 roots、状态索引和稳定 ID;不存在时静默跳过,不能凭旧路径猜测。
8
+ 2. 根据当前请求、Work 分支、关键词、状态和 provenance 定位最小相关 entry。
9
+ 3. 只回读命中的 entry 和直接 provenance;需要恢复、冲突裁决、归档、迁移或执行安全证明时,才读取该阶段声明的完整证据集合。
10
+ 4. 没有匹配证据时返回缺失证据并停止依赖该结论的分支,不补造事实。
11
+
12
+ ## Memory writes
13
+
14
+ 正式知识、永久 context、synthesis 或 archive 写入前,先解析唯一 owner 与 gateway,检查 pending transaction、lock、未完成 promotion 和 recovery evidence。gateway 不明或事务未闭合时,只阻塞记忆写入,继续独立的只读审计、定位和验证。
15
+
16
+ 每次写入必须记录 source IDs、证据定位、验证时间或 digest;写入后重新读取索引和目标 entry,确认 owner、locator、内容和状态投影一致。原始证据不可被派生视图覆盖。
17
+
18
+ ## Read budget
19
+
20
+ 当前 Work 的权威状态、schema、Map/Plan、当前输入和直接所有权合同可以完整读取;非当前分支的知识树、历史 change、研究库、项目 Skill 和示例只按索引与关键词读取。执行、冲突、恢复和归档 Work 需要完整证据时,以该 Work 的显式合同为准。
@@ -9,5 +9,7 @@ auto_generated: true
9
9
 
10
10
  > 本文件由 `generate-index.mjs` 自动生成,**禁止手动编辑**。
11
11
 
12
+ 激活后读取 <Path>{roots.workflows}/person/common/rules/activation-and-memory.md</Path>:先定位相关 entry,再回读少量原文与 provenance;正式写入前检查 owner/gateway、pending transaction、lock 和 recovery evidence。
13
+
12
14
  - **M-mao-zedong-cognitive-os** — 毛泽东认知操作系统:以毛泽东方法论为底座的问题诊断、战略制定与行动规划咨询
13
15
  - **S-steelman-deliberation** — 双向钢人论证:将尚未厘清的复杂问题经真实问题重述、正反双向钢人化与关键变量识别,在一次关键追问后推进为明确判断和可执行行动
@@ -11,6 +11,15 @@ keywords: [毛泽东, 毛选, 矛盾分析, 战略, 组织, 咨询]
11
11
 
12
12
  本入口把"分析问题—制定战略—组织行动"组织为渐进披露的咨询流程。产物写入当前 `person/changes/<change>/`。
13
13
 
14
+ ## 读取范围
15
+
16
+ 1. 先读取 `<Path>{roots.workflows}/person/INDEX.md</Path>` 与当前 Work 的状态入口;Person 使用整文件 INDEX,不加载不存在的 README。
17
+ 2. 再读取 `<Path>{roots.workflows}/person/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
18
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
19
+
20
+ 引用检索固定为:先读取当前 phase 的 framework index,再读取 `references/research/15-quote-bank.md` 定位篇目编号,最后只回读匹配的 `books/src/NNN-*.md`;不扫描整套书籍,无匹配证据时停止引用或结论。
21
+
22
+
14
23
  ## 流程
15
24
 
16
25
  ### 1. 激活与问诊
@@ -12,6 +12,6 @@
12
12
 
13
13
  ## 引用纪律
14
14
 
15
- 1. 引金句先读 `references/research/15-quote-bank.md`,再按编号打开 `src/NNN-*.md`。
15
+ 1. 引金句先读 `references/research/15-quote-bank.md`,再按编号打开单个 `src/NNN-*.md`;不得默认扫描或整读 `books/src/`。
16
16
  2. 逐字原文加引号并标注篇目;概括转述标注「转述/大意」。
17
17
  3. 建国后争议文本只取方法论句,并附边界提示。
@@ -18,6 +18,13 @@ keywords: [双向钢人, steelman, 决策, 反谄媚, 关键变量, 明确判断
18
18
  3. 找出双方真正的分歧,以及最可能改变结论的关键变量;
19
19
  4. 只问用户一个最关键的问题;等用户回答后,再给出明确判断、理由和下一步行动。
20
20
 
21
+ ## 读取范围
22
+
23
+ 1. 先读取 `<Path>{roots.workflows}/person/INDEX.md</Path>` 与当前 Work 的状态入口;Person 使用整文件 INDEX,不加载不存在的 README。
24
+ 2. 再读取 `<Path>{roots.workflows}/person/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
25
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
26
+
27
+
21
28
  ## 输入、权威与边界
22
29
 
23
30
  ### 必需输入
@@ -0,0 +1,20 @@
1
+ # Activation and memory retrieval protocol
2
+
3
+ 本规则只在用户明确激活当前 workflow 或某个 Work 后读取。INDEX 只用于被动发现,不初始化状态、不读取 active change、不写入知识。
4
+
5
+ ## Locate before read
6
+
7
+ 1. 先解析当前 workflow 的 roots、状态索引和稳定 ID;不存在时静默跳过,不能凭旧路径猜测。
8
+ 2. 根据当前请求、Work 分支、关键词、状态和 provenance 定位最小相关 entry。
9
+ 3. 只回读命中的 entry 和直接 provenance;需要恢复、冲突裁决、归档、迁移或执行安全证明时,才读取该阶段声明的完整证据集合。
10
+ 4. 没有匹配证据时返回缺失证据并停止依赖该结论的分支,不补造事实。
11
+
12
+ ## Memory writes
13
+
14
+ 正式知识、永久 context、synthesis 或 archive 写入前,先解析唯一 owner 与 gateway,检查 pending transaction、lock、未完成 promotion 和 recovery evidence。gateway 不明或事务未闭合时,只阻塞记忆写入,继续独立的只读审计、定位和验证。
15
+
16
+ 每次写入必须记录 source IDs、证据定位、验证时间或 digest;写入后重新读取索引和目标 entry,确认 owner、locator、内容和状态投影一致。原始证据不可被派生视图覆盖。
17
+
18
+ ## Read budget
19
+
20
+ 当前 Work 的权威状态、schema、Map/Plan、当前输入和直接所有权合同可以完整读取;非当前分支的知识树、历史 change、研究库、项目 Skill 和示例只按索引与关键词读取。执行、冲突、恢复和归档 Work 需要完整证据时,以该 Work 的显式合同为准。
@@ -13,6 +13,13 @@ keywords: [归档, consolidation, ADR, context, research, knowledge, 代码库
13
13
 
14
14
  A 是 SpecDev 的归档 wrapper:它拥有模式选择、SpecDev 完成门和代码访谈;机械扫描、dry-run、知识毕业、合并、清理、移动与重读由 `<Path>{roots.skills}/archive-and-consolidate/SKILL.md</Path>` 单一维护。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 模式
17
24
 
18
25
  - **archive**:处理用户指定或唯一的 completed change。
@@ -13,6 +13,13 @@ keywords: [code-review, review, diff, fixed-point, PR, 标准, 规范]
13
13
 
14
14
  C 是独立 review 入口,不实施修复。它拥有 `<Path>{roots.state}/specdev/changes/{change}/reviews/</Path>`;I 的最终审查由 I 写入 Evidence,不写本目录。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 输入
17
24
 
18
25
  - 用户提供的 commit、branch、tag、merge-base 或 PR locator;缺失时只询问固定点。
@@ -13,6 +13,13 @@ keywords: [bug, 诊断, 红灯, tight-loop, 根因, 复现, 假设]
13
13
 
14
14
  D 的主导词是**红灯**:没有一条已执行且能在此 bug 上变红的紧凑命令,就没有可进入的假设阶段。D 默认只读项目代码,可以创建 change 诊断工件和经授权的临时可撤销探针;生产修复由 Implement 拥有。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 输入与所有权
17
24
 
18
25
  按存在情况读取:
@@ -17,6 +17,13 @@ keywords: [设计访谈, grilling, design-tree, frontier, ADR, LOG, CONTEXT, 决
17
17
 
18
18
  本 work 只把访谈写成当前 change 的可恢复工件:设计树保存进度,LOG 保存讨论轨迹,CONTEXT 保存本 change 已确认的规范语言,ADR 保存已成为本 change 下游合同的架构决定。这些工件不等于项目永久知识,也不构成实现授权;永久 namespace 对 G 只读,只有 `<Path>{roots.workflows}/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md</Path>` 能在实现证据、毕业评估和用户确认通过后执行提升。
19
19
 
20
+ ## 读取范围
21
+
22
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
23
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
24
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
25
+
26
+
20
27
  ## 输入与产物
21
28
 
22
29
  按存在情况读取:
@@ -15,6 +15,13 @@ keywords: [实现, TDD, Lead, subagent, worktree, current workspace, direct-pare
15
15
 
16
16
  若当前 change 是未完成父 Implementation Map 的成员,必须读取 `<Path>{roots.workflows}/specdev/common/rules/parent-implementation-orchestration.md</Path>`、父 Map 与父 Plan。父 Plan 提供跨 change dependency/serialization、全局 workspace 策略、组合派单标识、implementation agent cap 和 integration queue;子 Goal Plan 只能增加子内 Gate,不能放宽或冲突。
17
17
 
18
+ ## 读取范围
19
+
20
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
21
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
22
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
23
+
24
+
18
25
  ## 执行模式
19
26
 
20
27
  ### Ticket 模式(默认)
@@ -4,7 +4,7 @@
4
4
 
5
5
  - [ ] Ticket frontmatter 可解析,`ready: true`,`status: ready`。
6
6
  - [ ] Tickets Map 已完整读取,包含总体实施背景和项目 Skill 读取矩阵;当前 Ticket 被 `ALL` 或自身 ID 覆盖。
7
- - [ ] 当前 Ticket 映射的项目 Skill 路径均为真实存在的项目根相对入口文件,Lead 已完整读取;implementation subagent Packet 包含 Map 与同一最低必读集合。
7
+ - [ ] 当前 Ticket 映射的项目 Skill 路径均为真实存在的项目根相对入口文件,Lead 已读取入口并完整展开命中的 Skill;implementation subagent Packet 包含 Map 与同一最低必读集合。
8
8
  - [ ] 项目 Agent 指令或当前实现范围没有触发矩阵外的未读项目 Skill;发现新匹配项时由 Lead 更新 Map、重新运行 tickets 校验后再恢复项目写入。
9
9
  - [ ] 所有 `blocked_by` Ticket 为 done 且 Evidence 存在。
10
10
  - [ ] Spec、ADR、Ticket 与 Goal Plan 无冲突;旧 Goal Plan schema 必须重跑 P-goal-plan。
@@ -13,6 +13,13 @@ keywords: [初始化, 配置, status, tracking, 验证命令]
13
13
 
14
14
  首次使用 SpecDev、状态根不存在或治理契约发生变化后运行。此 work 只初始化 SpecDev 的状态与配置,不修改项目业务代码。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 规范输入
17
24
 
18
25
  - 工作流运行合同:`<Path>{roots.workflows}/specdev/README.md</Path>`
@@ -11,6 +11,8 @@ keywords: [specdev, local-first, 规格驱动开发, decision-complete, prototyp
11
11
 
12
12
  本索引用于发现 SpecDev,并让未激活 SpecDev 的会话按需取得项目已经沉淀的长期知识。
13
13
 
14
+ 激活后读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`:先定位相关 entry,再回读少量原文与 provenance;正式写入前检查 owner/gateway、pending transaction、lock 和 recovery evidence。
15
+
14
16
  ## 永久知识
15
17
 
16
18
  读取本索引时,只把与当前请求相关且已经存在的内容作为只读背景;不存在的路径静默跳过:
@@ -11,6 +11,13 @@ keywords: [learn-change, change 学习, 开发后提问, 零基础, 大一新生
11
11
 
12
12
  > 激活本 Work 后,先读取 `<Path>{roots.workflows}/specdev/README.md</Path>`,再执行本入口。
13
13
 
14
+ ## 读取范围
15
+
16
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
17
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
18
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
19
+
20
+
14
21
  ## 读者与职责
15
22
 
16
23
  读者是刚入大学、没有专业背景(零专业背景)的新生。读者能理解日常因果和简单流程,但不应被假定知道代码、网络、数学或行业背景。
@@ -17,6 +17,13 @@ keywords: [实现编排, 父 change, super-DAG, Ticket, Lead, agent team, worktr
17
17
 
18
18
  父 change 的主产物是 `<Path>{roots.state}/specdev/changes/{change}/implementation-map.md</Path>` 与 `<Path>{roots.state}/specdev/changes/{change}/implementation-plan.md</Path>`;整体验证写入 `<Path>{roots.state}/specdev/changes/{change}/evidence/implementation-orchestration.md</Path>`。
19
19
 
20
+ ## 读取范围
21
+
22
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
23
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
24
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
25
+
26
+
20
27
  ## 激活输入
21
28
 
22
29
  创建模式必须获得至少两个用户明确指定的 change。恢复模式由用户指定父 change,或从 active change 中唯一满足 `current_work=specdev/orchestrate-implementation` 且存在父实现产物者确定。
@@ -27,10 +34,12 @@ keywords: [实现编排, 父 change, super-DAG, Ticket, Lead, agent team, worktr
27
34
  - 每个成员的 `<Path>{roots.state}/specdev/changes/{member-change}/.status.json</Path>`;
28
35
  - 每个成员的 `<Path>{roots.state}/specdev/changes/{member-change}/spec.md</Path>`;
29
36
  - 每个成员的 `<Path>{roots.state}/specdev/changes/{member-change}/tickets-map.md</Path>`;
30
- - 每个成员的 `<Path>{roots.state}/specdev/changes/{member-change}/ticket/</Path>`;
37
+ - 每个成员的 `<Path>{roots.state}/specdev/changes/{member-change}/ticket/</Path>`:先枚举所有 Ticket frontmatter、依赖、状态和可写路径,再按 super-DAG、冲突和当前 frontier 回读相关正文;
31
38
  - 存在时读取子 Goal Plan、ADR、CONTEXT、LOG、Diagnosis 与 Evidence;
32
39
  - 当前 repository、branch、HEAD、dirty 状态、项目 Agent 指令与可用验证命令。
33
40
 
41
+ 成员的 Spec、Tickets Map、Ticket frontmatter、状态和父级编排证据是 super-DAG 的权威输入,必须完整读取;成员的 ADR、CONTEXT、LOG、Diagnosis、Evidence、研究资料和项目 Skills 先按索引、状态和关键词定位,只读取命中的条目。恢复、冲突、漂移和集成失败时按本 Work 的证据合同扩展为全量读取。
42
+
34
43
  加载 `<Path>{roots.workflows}/specdev/O-orchestrate-implementation/input-readiness.md</Path>` 和 `<Path>{roots.workflows}/specdev/common/rules/parent-implementation-orchestration.md</Path>`。任何成员未实现就绪、已归档、等于父 change、属于另一个未完成父实现 change,或本身是父实现 change 时,不创建父 change。
35
44
 
36
45
  ## 流程
@@ -17,6 +17,13 @@ Goal Plan 只拥有单个 Ticket 无法独立决定的事情:整体 Outcome、
17
17
 
18
18
  产物写入 `<Path>{roots.state}/specdev/changes/{change}/goal-plan.md</Path>`。
19
19
 
20
+ ## 读取范围
21
+
22
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
23
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
24
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
25
+
26
+
20
27
  ## 何时运行
21
28
 
22
29
  满足任一条件时运行:
@@ -36,7 +43,7 @@ Goal Plan 只拥有单个 Ticket 无法独立决定的事情:整体 Outcome、
36
43
 
37
44
  - `<Path>{roots.state}/specdev/changes/{change}/spec.md</Path>`
38
45
  - `<Path>{roots.state}/specdev/changes/{change}/tickets-map.md</Path>`
39
- - `<Path>{roots.state}/specdev/changes/{change}/ticket/</Path>`
46
+ - `<Path>{roots.state}/specdev/changes/{change}/ticket/</Path>`:先枚举 Ticket 入口的 frontmatter、依赖和状态,按 DAG、路径和风险定位需要完整读取的 Ticket。
40
47
  - `<Path>{roots.state}/specdev/config.json</Path>`
41
48
 
42
49
  按存在情况读取:
@@ -49,6 +56,8 @@ Goal Plan 只拥有单个 Ticket 无法独立决定的事情:整体 Outcome、
49
56
  - 永久领域上下文:`<Path>{roots.state}/specdev/context/</Path>`
50
57
  - 用户提供的合同、标准、参考实现、环境限制、发布窗口和批准策略。
51
58
 
59
+ 非当前分支的 ADR、CONTEXT、LOG、Diagnosis、Evidence、研究资料和永久目录先通过索引、状态和关键词定位;只有被当前 Gate、依赖、冲突或恢复条件命中的条目才回读原文。Tickets Map、当前计划和决定 DAG 的 Ticket frontmatter 是权威编排输入,仍需完整读取。
60
+
52
61
  永久目录可以为空,静默继续。缺少 Spec 或 Tickets Map 时返回 `<Path>{roots.workflows}/specdev/S-spec/S-spec.md</Path>` 或 `<Path>{roots.workflows}/specdev/T-tickets/T-tickets.md</Path>`;当前 ADR/CONTEXT 缺失且规划依赖对应决定时返回 `<Path>{roots.workflows}/specdev/G-grill-with-docs/G-grill-with-docs.md</Path>`,不在 Goal Plan 中补造上游权威。
53
62
 
54
63
  ## 流程
@@ -13,6 +13,13 @@ keywords: [prototype, UI 原型, 风格检测, 设计系统, HTML, CSS, 交互,
13
13
 
14
14
  本 Work 的主导词是**设计定向**:先从项目事实识别现状,再让用户看到基于功能而非流行色推荐的候选,最后把选择固化为既可阅读又可运行的 UI 设计包。P 不修改生产 UI;后续 S、Tickets 和 I 以设计包为视觉与交互权威。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 输入与所有权
17
24
 
18
25
  - 必需输入:目标项目或新产品设想、核心用户任务,以及当前 SpecDev change。
@@ -20,6 +20,13 @@ keywords: [architecture, review, module, interface, depth, seam, adapter, levera
20
20
 
21
21
  本 work 只审查、呈现和访谈,不直接修改产品代码。
22
22
 
23
+ ## 读取范围
24
+
25
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
26
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
27
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
28
+
29
+
23
30
  ## 输入与产物
24
31
 
25
32
  按存在情况读取:
@@ -245,6 +245,7 @@ Change 从 active/blocked 转为 completed 时加载 `<Path>{roots.workflows}/sp
245
245
  - Schemas:`<Path>{roots.workflows}/specdev/common/schemas/</Path>`
246
246
  - Tools:`<Path>{roots.workflows}/specdev/common/tools/</Path>`
247
247
  - Skills:`<Path>{roots.workflows}/specdev/common/skills/</Path>`
248
+ - 激活与记忆读取规则:`<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`
248
249
 
249
250
  ## 自动校验
250
251
 
@@ -261,3 +262,5 @@ node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
261
262
  ```bash
262
263
  node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> --self-check
263
264
  ```
265
+
266
+ 激活后读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`:先定位相关 entry,再回读少量原文与 provenance;正式写入前检查 owner/gateway、pending transaction、lock 和 recovery evidence。
@@ -15,6 +15,13 @@ keywords: [spec, PRD, 用户故事, 验收合同, 接缝, 范围, readiness]
15
15
 
16
16
  Spec 决定“为什么、为谁、系统应表现为何”。它可以锁定影响公共接口、数据、兼容、安全或验收的实现约束,但不写逐文件施工计划。
17
17
 
18
+ ## 读取范围
19
+
20
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
21
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
22
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
23
+
24
+
18
25
  ## 输入
19
26
 
20
27
  按存在情况读取:
@@ -15,6 +15,13 @@ Ticket 是**决策完备的微型执行计划**:它消除执行者在目标、
15
15
 
16
16
  本 work 保留原有能力:代码库探索、prefactor 识别、曳光弹垂直切片、真实阻塞边、用户粒度核对、宽重构的 expand-contract 排序、Ticket 独立文件和总体 Tickets Map。
17
17
 
18
+ ## 读取范围
19
+
20
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
21
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
22
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
23
+
24
+
18
25
  ## 输入
19
26
 
20
27
  优先读取:
@@ -35,7 +42,7 @@ Ticket 是**决策完备的微型执行计划**:它消除执行者在目标、
35
42
 
36
43
  ### 1. 输入预检
37
44
 
38
- 1. 读取所有存在的上游工件;
45
+ 1. 先读取上游工件索引,按当前 Ticket 的依赖、缺口和冲突关键词定位,再回读相关工件;
39
46
  2. 检查 `<Path>{roots.state}/specdev/changes/{change}/spec.md</Path>` 的 `ready_for_tickets`;
40
47
  3. 按 `<Path>{roots.workflows}/specdev/common/rules/artifact-contract.md</Path>` 处理 Spec、ADR、用户决定与代码事实的冲突;
41
48
  4. 将未知项分类为可发现事实、高影响用户决定和低影响实现细节;
@@ -59,8 +66,8 @@ Ticket 是**决策完备的微型执行计划**:它消除执行者在目标、
59
66
  #### 项目 Skill 路由
60
67
 
61
68
  1. 读取项目 Agent 指令,确定项目声明的 Skill 根;至少枚举 `<Path>.agents/skills/**/SKILL.md</Path>`,存在其他项目级 Skill 根时一并枚举;
62
- 2. 先读取候选 Skill 的 frontmatter 与入口路由;存在 `<Path>.agents/skills/engineering-standards/SKILL.md</Path>` 时完整读取,并按其 Skill Map 路由到当前 change 需要的领域 Skill;
63
- 3. 根据整个 change 和每个 Ticket 的路径、技术域、公共契约、迁移与验证范围,确定 `ALL` 或具体 Ticket 的最低必读集合;只把真实存在且触发条件匹配的项目 Skill 纳入;
69
+ 2. 先读取候选 Skill 的 frontmatter 与入口路由;只有命中当前 change scope、路径、技术域或验证条件时才完整读取,并按其 Skill Map 路由到当前 change 需要的领域 Skill;
70
+ 3. 根据 change 索引、每个 Ticket frontmatter、路径、技术域、公共契约、迁移与验证范围,确定 `ALL` 或具体 Ticket 的最低必读集合;只把真实存在且触发条件匹配的项目 Skill 纳入;
64
71
  4. 使用项目根相对 Path 记录每个 Skill 的入口文件,同时记录触发 scope、读取时机和用途;不得把 Speculo 自带 Skill 或机器绝对路径伪装成项目 Skill;
65
72
  5. 未发现适用项目 Skill 时,记录已扫描的 Skill 根和“无适用项”,不生成虚假路径;项目 Skill 清单是最低集合而非 allowlist。
66
73
 
@@ -26,7 +26,7 @@ shared_path_owners: []
26
26
  - **上游 Spec:** `<Path>{roots.state}/specdev/changes/{change}/spec.md</Path>`
27
27
  - **完成 Evidence:** `<Path>{roots.state}/specdev/changes/{change}/evidence/T-01.md</Path>`
28
28
 
29
- 实现本 Ticket 时,Lead 与 implementation subagent 必须按顺序完整读取总体 Map、其中适用于 `ALL`/`T-01` 的项目 Skill,再读取本 Ticket 与其他上游工件。Map 中的 Skill 是最低必读集合;新的匹配项先由 Lead 同步到 Map 并重新校验。
29
+ 实现本 Ticket 时,Lead 与 implementation subagent 必须按顺序完整读取总体 Map,读取项目 Skill 的 frontmatter 与入口并只展开适用于 `ALL`/`T-01` 的匹配项,再读取本 Ticket 与相关上游工件。Map 中的 Skill 是最低必读集合;新的匹配项先由 Lead 同步到 Map 并重新校验。
30
30
 
31
31
  ## 1. 战略与来源
32
32
 
@@ -125,7 +125,7 @@ E2E 由实际跨边界行为与风险决定,不限于 UI;required 模式不
125
125
  ## 10. 验收标准
126
126
 
127
127
  - [ ] `AC-001`:<可判定结果>。
128
- - [ ] 实现开始前已完整读取 Tickets Map 及其中适用于 `ALL`/`T-01` 的项目 Skill;新发现的匹配 Skill 已由 Lead 同步回 Map。
128
+ - [ ] 实现开始前已完整读取 Tickets Map,已读取项目 Skill 入口并完整展开其中适用于 `ALL`/`T-01` 的匹配项;新发现的匹配 Skill 已由 Lead 同步回 Map。
129
129
  - [ ] 验证矩阵全部执行并记录到 `<Path>{roots.state}/specdev/changes/{change}/evidence/T-01.md</Path>`。
130
130
  - [ ] 实际项目修改未超出 `writable_paths`,shared path 由指定 owner 修改。
131
131
  - [ ] Ticket 已按 Goal Plan 策略形成非空 implementation/source commit,direct-parent 或 candidate 验证通过且父分支 result 已记录。
@@ -23,7 +23,7 @@ status: draft
23
23
 
24
24
  ### 项目 Skill 读取矩阵
25
25
 
26
- 每个 Ticket 的 Lead 或 implementation subagent 都必须先完整读取本 Map,再读取下表中适用于 `ALL` 或当前 Ticket ID 的项目 Skill,最后进入当前 Ticket。下表是发布时已确认的**最低必读集合,不是 Skill allowlist**;项目 Agent 指令或实现范围触发其他项目 Skill 时,先读取该 Skill,并由 Lead 更新本 Map、重新校验后继续。
26
+ 每个 Ticket 的 Lead 或 implementation subagent 都必须先完整读取本 Map,再读取候选项目 Skill 的 frontmatter 与入口;只有适用于 `ALL` 或当前 Ticket ID、且 scope/路径/技术域/验证条件命中的 Skill 才完整读取,最后进入当前 Ticket。下表是发布时已确认的**最低必读集合,不是 Skill allowlist**;项目 Agent 指令或实现范围触发其他项目 Skill 时,先定位并读取其入口,由 Lead 更新本 Map、重新校验后继续。
27
27
 
28
28
  项目 Skill 使用项目根相对 Path,例如 `<Path>.agents/skills/{skill-name}/SKILL.md</Path>`;不得写机器绝对路径。若没有适用项目 Skill,保留一行 `无(已扫描项目 Skill 入口,未发现适用项)`,并在 Trigger / Scope 中记录实际扫描范围。
29
29
 
@@ -13,6 +13,13 @@ keywords: [triage, 摄入, import, issue, reconcile, close, 风险, 路由]
13
13
 
14
14
  Triage 是 SpecDev 唯一的远程摄入与关闭边界。开发期间,`<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`、Spec、Ticket、Map、Goal Plan、Evidence 和状态文件是唯一权威;远程系统只保存原始请求以及经确认后的完成通知。
15
15
 
16
+ ## 读取范围
17
+
18
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
19
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
20
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
21
+
22
+
16
23
  ## 模式
17
24
 
18
25
  - **intake**:冻结输入、创建或恢复 change、分类并返回下一 Work。
@@ -15,6 +15,13 @@ keywords: [wayfinder, 寻路, shared-map, research, prototype, grilling, task,
15
15
 
16
16
  目的地可能是一份待移交和迭代的 Spec、一个在规划开始前需锁定的决策,或一项经说明允许在地图中完成的变更。命名目的地是第一步,它塑造每个 Ticket。
17
17
 
18
+ ## 读取范围
19
+
20
+ 1. 先读取 `<Path>{roots.workflows}/specdev/README.md</Path>` 与当前 Work 的状态入口。
21
+ 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`,按当前分支、状态和关键词定位最小相关工件。
22
+ 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取;缺少匹配证据或 owner/gateway 时停止受影响分支。
23
+
24
+
18
25
  ## 核心纪律
19
26
 
20
27
  ### 规划,而非执行
@@ -11,6 +11,7 @@
11
11
 
12
12
  ## 规则权威
13
13
 
14
+ - 激活与记忆读取、事务门:`<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`;它定义 locate-before-read 和写入前 owner/gateway 检查,其他规则只声明领域专属约束。
14
15
  - 工件职责与冲突裁决:`<Path>{roots.workflows}/specdev/common/rules/artifact-contract.md</Path>`
15
16
  - 规划原则:`<Path>{roots.workflows}/specdev/common/rules/planning-principles.md</Path>`
16
17
  - 规划深度与就绪:`<Path>{roots.workflows}/specdev/common/rules/readiness-and-depth.md</Path>`
@@ -0,0 +1,20 @@
1
+ # Activation and memory retrieval protocol
2
+
3
+ 本规则只在用户明确激活当前 workflow 或某个 Work 后读取。INDEX 只用于被动发现,不初始化状态、不读取 active change、不写入知识。
4
+
5
+ ## Locate before read
6
+
7
+ 1. 先解析当前 workflow 的 roots、状态索引和稳定 ID;不存在时静默跳过,不能凭旧路径猜测。
8
+ 2. 根据当前请求、Work 分支、关键词、状态和 provenance 定位最小相关 entry。
9
+ 3. 只回读命中的 entry 和直接 provenance;需要恢复、冲突裁决、归档、迁移或执行安全证明时,才读取该阶段声明的完整证据集合。
10
+ 4. 没有匹配证据时返回缺失证据并停止依赖该结论的分支,不补造事实。
11
+
12
+ ## Memory writes
13
+
14
+ 正式知识、永久 context、synthesis 或 archive 写入前,先解析唯一 owner 与 gateway,检查 pending transaction、lock、未完成 promotion 和 recovery evidence。gateway 不明或事务未闭合时,只阻塞记忆写入,继续独立的只读审计、定位和验证。
15
+
16
+ 每次写入必须记录 source IDs、证据定位、验证时间或 digest;写入后重新读取索引和目标 entry,确认 owner、locator、内容和状态投影一致。原始证据不可被派生视图覆盖。
17
+
18
+ ## Read budget
19
+
20
+ 当前 Work 的权威状态、schema、Map/Plan、当前输入和直接所有权合同可以完整读取;非当前分支的知识树、历史 change、研究库、项目 Skill 和示例只按索引与关键词读取。执行、冲突、恢复和归档 Work 需要完整证据时,以该 Work 的显式合同为准。