@namewta/speculo 0.2.3 → 0.2.7

package/template/workflows/matt-pocock/routes/productivity.md

@@ -1,25 +0,0 @@
-# Productivity
-
-## 路由
-
-```xml
-<routes>
-  <route id="handoff" order="1">
-    <instructions root="workflow" path="atomic-skills/handoff.md" activation="adapted" />
-    <artifact root="change" path="handoffs/{topic}.md" />
-    <when>需要跨会话或分叉上下文。</when>
-  </route>
-  <route id="teach" order="2">
-    <instructions root="workflow" path="atomic-skills/teach.md" activation="adapted" />
-    <artifact root="change" path="teaching/" />
-    <when>用户要跨会话学习主题。</when>
-  </route>
-  <route id="writing-great-skills" order="3">
-    <instructions root="workflow" path="atomic-skills/writing-great-skills.md" activation="required" />
-    <artifact root="change" path="skill-authoring/report.md" />
-    <when>用户要设计或审查 skill。</when>
-  </route>
-</routes>
-```
-
-原 handoff 的系统临时目录与 teach 的当前目录均替换为上述 change 内路径。

package/template/workflows/matt-pocock/routes/research-prototype.md

@@ -1,20 +0,0 @@
-# Research And Prototype
-
-## 阶段
-
-```xml
-<sequence>
-  <phase id="research" order="1">
-    <when>答案需要当前仓库之外的一手来源。</when>
-    <instructions root="workflow" path="atomic-skills/research.md" activation="conditional" />
-    <artifact root="change" path="research/{topic}.md" />
-    <completion>每项结论有一手来源，文件留在当前 change。</completion>
-  </phase>
-  <phase id="prototype" order="2">
-    <when>状态、逻辑或 UI 需要可运行答案。</when>
-    <instructions root="workflow" path="atomic-skills/prototype.md" activation="conditional" />
-    <artifact root="change" path="prototypes/{topic}/answer.md" />
-    <completion>答案已保留；一次性代码、数据库和路由已删除或明确吸收进实现。</completion>
-  </phase>
-</sequence>
-```

package/template/workflows/matt-pocock/routes/review.md

@@ -1,19 +0,0 @@
-# Review
-
-## 阶段
-
-```xml
-<sequence>
-  <phase id="fixed-point" order="1">
-    <instructions root="workflow" path="atomic-skills/code-review.md" activation="required" />
-    <completion>固定点可解析、diff 非空、规范与标准来源已记录。</completion>
-  </phase>
-  <phase id="parallel-axes" order="2">
-    <artifact root="change" path="review/report.md" />
-    <completion>标准轴与规范轴相互隔离执行，并排呈现且不重新排名。</completion>
-  </phase>
-  <phase id="decision" order="3">
-    <completion>发现数量、各轴最严重问题和下一步已记录；未经要求不实施修复。</completion>
-  </phase>
-</sequence>
-```

package/template/workflows/matt-pocock/routes/setup.md

@@ -1,42 +0,0 @@
-# Route Setup
-
-仅在目标 route 缺少配置时读取原 setup skill；保持其探索和逐项确认方法，但使用 Matt 已声明的 state namespace。
-
-## 阶段
-
-```xml
-<sequence>
-  <phase id="discover-config" order="1">
-    <instructions root="workflow" path="atomic-skills/setup-matt-pocock-skills.md" activation="adapted" />
-    <completion>已展示仓库、tracker 和领域文档现状。</completion>
-  </phase>
-  <phase id="configure-tracker" order="2">
-    <when>route 需要 issue tracker。</when>
-    <template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/issue-tracker-local.md" />
-    <artifact root="state" path="integrations/issue-tracker.md" />
-    <completion>用户已确认 GitHub、GitLab、本地或其他 tracker；本地 tracker 根为当前 change/tracker。</completion>
-  </phase>
-  <phase id="configure-triage" order="3">
-    <when>route 为 triage 或 wayfinder。</when>
-    <template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/triage-labels.md" />
-    <artifact root="state" path="integrations/triage-labels.md" />
-    <completion>五个角色已映射到真实标签。</completion>
-  </phase>
-  <phase id="configure-domain" order="4">
-    <when>route 会读取或维护领域语言。</when>
-    <template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/domain.md" />
-    <artifact root="state" path="knowledge/domain.md" />
-    <completion>domain.md 指向本 workflow 的 knowledge/context/ 与 knowledge/adr/，未修改项目根 AGENTS/CLAUDE/docs。</completion>
-  </phase>
-</sequence>
-```
-
-## 状态转移
-
-```xml
-<transitions>
-  <transition from="missing-config" to="configured">
-    <when>目标 route 的必要配置均已由用户确认并写入声明 namespace。</when>
-  </transition>
-</transitions>
-```

package/template/workflows/matt-pocock/routes/triage.md

@@ -1,25 +0,0 @@
-# Triage
-
-## 阶段
-
-```xml
-<sequence>
-  <phase id="collect" order="1">
-    <instructions root="workflow" path="atomic-skills/triage.md" activation="adapted" />
-    <artifact root="change" path="triage/{item}/record.md" />
-    <completion>完整正文、评论、标签、diff、冗余性与私有 out-of-scope 已检查。</completion>
-  </phase>
-  <phase id="recommend" order="2">
-    <completion>类别与状态建议已向维护者展示并等待决定。</completion>
-  </phase>
-  <phase id="validate-grill" order="3">
-    <when>声明需要复现或需求仍不完整。</when>
-    <instructions root="workflow" path="atomic-skills/grilling.md" activation="conditional" />
-    <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional" />
-    <completion>事实已验证，问题逐个解决。</completion>
-  </phase>
-  <phase id="apply" order="4">
-    <completion>拟发布评论、标签、关闭动作先本地记录并经确认；结果引用已写回。</completion>
-  </phase>
-</sequence>
-```

package/template/workflows/matt-pocock/routes/wayfinder.md

@@ -1,27 +0,0 @@
-# Wayfinder
-
-## 阶段
-
-```xml
-<sequence>
-  <phase id="name-destination" order="1">
-    <instructions root="workflow" path="atomic-skills/wayfinder.md" activation="required" />
-    <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
-    <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
-    <completion>目的地与范围边界已确认。</completion>
-  </phase>
-  <phase id="map-frontier" order="2">
-    <artifact root="change" path="wayfinder/map.md" />
-    <artifact root="change" path="wayfinder/tickets/" />
-    <completion>只创建当前可明确的 tickets，战争迷雾留在 map。</completion>
-  </phase>
-  <phase id="walk-one-ticket" order="3">
-    <completion>一次会话只领取并解决一个前沿 ticket；本地先记录，外发需确认。</completion>
-  </phase>
-  <phase id="handoff" order="4">
-    <when>路径已清晰。</when>
-    <instructions root="workflow" path="routes/idea-to-delivery.md" />
-    <completion>已转入 spec 或 implement，未把寻路当成交付。</completion>
-  </phase>
-</sequence>
-```

package/template/workflows/person/PERSISTENCE.md

@@ -1,56 +0,0 @@
-# Person Persistence
-
-本文件是 `person` 的唯一运行契约。`WORKFLOW.md` 只能引用本文件，不得复制 runtime roots、store、change 启动或副作用规则。进入 person workflow 时先读取项目根 `speculo/.speculo/workspace.json`，再执行本文件。
-
-## 运行时根
-
-```xml
-<runtime-context>
-  <root id="workflow" base="workflows" path="person" />
-  <root id="state" base="state" path="person" />
-</runtime-context>
-```
-
-## 持久化命名空间
-
-```xml
-<persistence root="state">
-  <store id="index" role="index" kind="file" path="status.json" create="initialize" />
-  <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
-  <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
-  <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
-</persistence>
-```
-
-## 启动协议
-
-```xml
-<sequence>
-  <phase id="resolve-runtime" order="1">
-    <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
-    <completion>workspace、config 与 workflow/state roots 均已解析并通过边界检查；同一运行已解析时复用结果。</completion>
-  </phase>
-  <phase id="select-change" order="2">
-    <artifact root="state" path="status.json" />
-    <completion>已选择用户指定或唯一 active change；没有 active change 时原子创建 `changes/YYYY-MM-DD-&lt;kebab-topic&gt;/.status.json` 并更新索引；多个候选时先消歧。</completion>
-  </phase>
-</sequence>
-```
-
-创建 change 时初始化 schema version 1、workflow/name/timestamps、`change_status: active`、空的 `route_history`。已有 change 缺少数组时按空数组读取，在下一次真实更新时补齐，不要求迁移。
-
-## 状态字段
-
-```xml
-<state-schema>
-  <field name="current_route" type="string|null" />
-  <field name="route_history" type="array" />
-</state-schema>
-```
-
-## 路径与副作用
-
-- route 产物只写当前 change；已声明 knowledge store 只接收 workflow 确认的长期内容。
-- 用户要求的项目产物不是 Speculo 运行状态；保存项目相对指针，不把派生绝对路径写入状态。
-- 发布、提交、移动或删除外部/项目资源前展示动作并取得明确确认。
-

package/template/workflows/person/WORKFLOW.md

@@ -1,50 +0,0 @@
----
-id: person
-type: workflow
-workflow: person
-name: Person Workflow
-description: 以人物方法论为底座并共享独立持久化契约的咨询 workflow
-keywords: [person, methodology, consulting, 人物, 方法论]
----
-
-# Person Workflow
-
-先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源；本入口只负责选择人物方法论 route。
-
-## 进入协议
-
-```xml
-<sequence>
-  <phase id="load-persistence" order="1">
-    <instructions root="workflow" path="PERSISTENCE.md" activation="required" />
-    <completion>runtime context 与 current change 已按唯一持久化契约解析。</completion>
-  </phase>
-</sequence>
-```
-
-## 路由
-
-```xml
-<routes>
-  <route id="mao-zedong-cognitive-os" order="1" root="workflow" path="M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md">
-    <when>用户希望以毛泽东方法论分析问题、制定战略或组织行动。</when>
-  </route>
-</routes>
-```
-
-## 依赖
-
-```xml
-<dependencies />
-```
-
-## 状态转移
-
-```xml
-<transitions>
-  <transition from="active" to="archived">
-    <command root="commands" path="finalize.md" />
-    <when>用户确认咨询交付完成且完成门禁通过。</when>
-  </transition>
-</transitions>
-```

package/template/workflows/person/_state/.config/LESSONS.md

@@ -1,3 +0,0 @@
-# Person Workflow Lessons
-
-仅记录经验证、可跨咨询 change 复用的经验。

package/template/workflows/person/_state/.config/RULES.md

@@ -1,3 +0,0 @@
-# Person Workflow Rules
-
-本文件由用户维护，用于记录人物方法论咨询的边界与硬约束。

package/template/workflows/person/_state/.config/context/.gitkeep

@@ -1 +0,0 @@
-

package/template/workflows/person/_templates/mao-consultation-output-template.md

@@ -1,55 +0,0 @@
-> **服务工作流：** `../M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md`
-> **产物文件名：** `consultation-output.md`
-> **父目录规则：** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
-
-# 咨询输出
-
-> 以下为教员第一人称的整合咨询答复。由 Phase 1-4 的 problem-statement、analysis、strategy、action-plan 整合而成。
-
-## 问题回顾
-
-同志，你来找我谈的是这么一件事——
-
-[TODO: 从 problem-statement.md 提炼，2-3 句概括用户处境]
-
-## 诊断
-
-[TODO: 从 analysis.md 提炼主要矛盾判断，遵循五拍论证节奏——破题→切割→定向→点睛→收尾]
-
-谁是我们的朋友？谁是我们的敌人？[TODO: 力量格局定性]
-
-这件事的根本问题，不是……而是……[TODO: 剥掉表象]
-
-捉住了这个主要矛盾——[TODO: 明确写出]，一切问题就迎刃而解了。
-
-这就像 [TODO: 1 个比喻点睛]
-
-## 战略
-
-我们的方针是——[TODO: 从 strategy.md 提炼，一句话方向判断]
-
-分几步走：[TODO: 阶段划分与关键战役]
-
-在战略上我们要藐视它，在战术上我们要重视它。[TODO: 具体展开]
-
-## 行动
-
-怎么打？[TODO: 从 action-plan.md 提炼，每个阶段配方法]
-
-桥和船在这里：[TODO: 具体方法，2-3 步]
-
-打了再看。实践是检验真理的唯一标准。[TODO: 检验方式]
-
-## 收尾
-
-[TODO: 给信心，承认道路曲折，落脚到"人"和"群众"]
-
-道路是曲折的，前途是光明的。
-
----
-
-## 引用索引
-
-| 引文 | 篇目 | 编号 |
-|------|------|------|
-[TODO: 逐条列出本文引用的毛泽东原文、篇目名、编号]