@namewta/speculo 0.1.20 → 0.2.0
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.
- package/README.md +68 -78
- package/dist/src/cli.js +57 -34
- package/dist/src/cli.js.map +1 -1
- package/dist/src/index.d.ts +1 -3
- package/dist/src/index.js +128 -168
- package/dist/src/index.js.map +1 -1
- package/dist/src/migrate.d.ts +38 -0
- package/dist/src/migrate.js +646 -0
- package/dist/src/migrate.js.map +1 -0
- package/dist/src/workflows.d.ts +7 -37
- package/dist/src/workflows.js +49 -123
- package/dist/src/workflows.js.map +1 -1
- package/package.json +6 -4
- package/template/.speculo/README.md +20 -0
- package/template/.speculo/workspace.json +12 -0
- package/template/commands/docs-sync.md +28 -0
- package/template/commands/finalize.md +37 -0
- package/template/commands/knowledge-prune.md +20 -0
- package/template/commands/retro.md +15 -8
- package/template/commands/status.md +8 -51
- package/template/skills/agents-md-builder/SKILL.md +14 -101
- package/template/skills/change-lifecycle/SKILL.md +25 -0
- package/template/{workflows/dev/_templates → skills/change-lifecycle/assets}/completion-summary-template.md +2 -2
- package/template/{workflows/dev/_templates → skills/change-lifecycle/assets}/completion-verification-template.md +1 -1
- package/template/skills/change-lifecycle/references/completion-gate.md +19 -0
- package/template/skills/change-lifecycle/references/finalize-archive.md +32 -0
- package/template/skills/docs-sync/SKILL.md +22 -0
- package/template/skills/docs-sync/assets/report-template.md +45 -0
- package/template/skills/docs-sync/assets/state-template.json +20 -0
- package/template/skills/docs-sync/assets/workflow-scope-template.json +9 -0
- package/template/skills/docs-sync/references/agents-contract.md +43 -0
- package/template/skills/docs-sync/references/changelog-contract.md +39 -0
- package/template/skills/docs-sync/references/document-lifecycle-contract.md +38 -0
- package/template/skills/docs-sync/references/git-state-contract.md +67 -0
- package/template/skills/docs-sync/references/readme-contract.md +44 -0
- package/template/skills/docs-sync/references/workflow-scope-contract.md +50 -0
- package/template/skills/github-npm-ops/SKILL.md +14 -39
- package/template/skills/github-npm-ops/references/failure-recovery.md +3 -3
- package/template/skills/github-npm-ops/references/issue-pr-triage.md +1 -1
- package/template/skills/github-npm-ops/references/preflight-checklist.md +4 -4
- package/template/skills/github-npm-ops/references/release-notes-injection.md +1 -1
- package/template/skills/github-npm-ops/references/release-pipeline.md +13 -13
- package/template/skills/github-npm-ops/references/version-bump-flow.md +3 -3
- package/template/skills/knowledge-prune/SKILL.md +29 -0
- package/template/skills/knowledge-prune/references/audit-rules.md +24 -0
- package/template/skills/runtime-context/SKILL.md +43 -0
- package/template/skills/runtime-context/references/path-resolution.md +32 -0
- package/template/skills/speculo-retro/SKILL.md +13 -37
- package/template/skills/speculo-retro/references/friction-taxonomy.md +3 -3
- package/template/skills/speculo-retro/references/issue-drafting-sop.md +3 -3
- package/template/skills/worktree-isolation/SKILL.md +10 -46
- package/template/skills/worktree-isolation/references/audit-branch-tree.md +2 -2
- package/template/skills/worktree-isolation/references/create-worktree.md +6 -6
- package/template/skills/worktree-isolation/references/merge-and-cleanup.md +5 -5
- package/template/vendor/README.md +11 -10
- package/template/vendor/matt-pocock/README.md +41 -0
- package/template/vendor/matt-pocock/engineering/README.md +28 -0
- package/template/vendor/matt-pocock/engineering/ask-matt/SKILL.md +76 -0
- package/template/vendor/matt-pocock/engineering/code-review/SKILL.md +89 -0
- package/template/vendor/matt-pocock/engineering/codebase-design/DEEPENING.md +37 -0
- package/template/vendor/matt-pocock/engineering/codebase-design/DESIGN-IT-TWICE.md +44 -0
- package/template/vendor/matt-pocock/engineering/codebase-design/SKILL.md +114 -0
- package/template/vendor/matt-pocock/engineering/diagnosing-bugs/SKILL.md +134 -0
- package/template/vendor/matt-pocock/engineering/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
- package/template/vendor/matt-pocock/engineering/domain-modeling/ADR-FORMAT.md +47 -0
- package/template/vendor/matt-pocock/engineering/domain-modeling/CONTEXT-FORMAT.md +60 -0
- package/template/vendor/matt-pocock/engineering/domain-modeling/SKILL.md +74 -0
- package/template/vendor/matt-pocock/engineering/grill-with-docs/SKILL.md +7 -0
- package/template/vendor/matt-pocock/engineering/implement/SKILL.md +15 -0
- package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/template/vendor/matt-pocock/engineering/improve-codebase-architecture/SKILL.md +66 -0
- package/template/vendor/matt-pocock/engineering/prototype/LOGIC.md +79 -0
- package/template/vendor/matt-pocock/engineering/prototype/SKILL.md +30 -0
- package/template/vendor/matt-pocock/engineering/prototype/UI.md +112 -0
- package/template/vendor/matt-pocock/engineering/research/SKILL.md +12 -0
- package/template/vendor/matt-pocock/engineering/resolving-merge-conflicts/SKILL.md +14 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/SKILL.md +127 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/domain.md +51 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-github.md +45 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +46 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/issue-tracker-local.md +30 -0
- package/template/vendor/matt-pocock/engineering/setup-matt-pocock-skills/triage-labels.md +15 -0
- package/template/vendor/matt-pocock/engineering/tdd/SKILL.md +36 -0
- package/template/vendor/matt-pocock/engineering/tdd/mocking.md +59 -0
- package/template/vendor/matt-pocock/engineering/tdd/tests.md +77 -0
- package/template/vendor/matt-pocock/engineering/to-spec/SKILL.md +75 -0
- package/template/vendor/matt-pocock/engineering/to-tickets/SKILL.md +113 -0
- package/template/vendor/matt-pocock/engineering/triage/AGENT-BRIEF.md +204 -0
- package/template/vendor/matt-pocock/engineering/triage/OUT-OF-SCOPE.md +104 -0
- package/template/vendor/matt-pocock/engineering/triage/SKILL.md +112 -0
- package/template/vendor/matt-pocock/engineering/wayfinder/SKILL.md +127 -0
- package/template/vendor/matt-pocock/in-progress/README.md +10 -0
- package/template/vendor/matt-pocock/in-progress/claude-handoff/SKILL.md +18 -0
- package/template/vendor/matt-pocock/in-progress/loop-me/SKILL.md +32 -0
- package/template/vendor/matt-pocock/in-progress/wizard/SKILL.md +45 -0
- package/template/vendor/matt-pocock/in-progress/wizard/template.sh +211 -0
- package/template/vendor/matt-pocock/in-progress/writing-beats/SKILL.md +67 -0
- package/template/vendor/matt-pocock/in-progress/writing-fragments/SKILL.md +78 -0
- package/template/vendor/matt-pocock/in-progress/writing-shape/SKILL.md +79 -0
- package/template/vendor/matt-pocock/productivity/README.md +18 -0
- package/template/vendor/matt-pocock/productivity/grill-me/SKILL.md +7 -0
- package/template/vendor/matt-pocock/productivity/grilling/SKILL.md +12 -0
- package/template/vendor/matt-pocock/productivity/handoff/SKILL.md +16 -0
- package/template/vendor/matt-pocock/productivity/teach/GLOSSARY-FORMAT.md +35 -0
- package/template/vendor/matt-pocock/productivity/teach/LEARNING-RECORD-FORMAT.md +46 -0
- package/template/vendor/matt-pocock/productivity/teach/MISSION-FORMAT.md +31 -0
- package/template/vendor/matt-pocock/productivity/teach/RESOURCES-FORMAT.md +32 -0
- package/template/vendor/matt-pocock/productivity/teach/SKILL.md +140 -0
- package/template/vendor/matt-pocock/productivity/writing-great-skills/GLOSSARY.md +201 -0
- package/template/vendor/matt-pocock/productivity/writing-great-skills/SKILL.md +83 -0
- package/template/workflows/matt-pocock/WORKFLOW.md +145 -0
- package/template/workflows/matt-pocock/_state/status.json +5 -0
- package/template/workflows/matt-pocock/routes/architecture.md +24 -0
- package/template/workflows/matt-pocock/routes/diagnose.md +22 -0
- package/template/workflows/matt-pocock/routes/experimental.md +18 -0
- package/template/workflows/matt-pocock/routes/idea-to-delivery.md +63 -0
- package/template/workflows/matt-pocock/routes/merge-conflicts.md +19 -0
- package/template/workflows/matt-pocock/routes/productivity.md +25 -0
- package/template/workflows/matt-pocock/routes/research-prototype.md +20 -0
- package/template/workflows/matt-pocock/routes/review.md +19 -0
- package/template/workflows/matt-pocock/routes/setup.md +42 -0
- package/template/workflows/matt-pocock/routes/triage.md +25 -0
- package/template/workflows/matt-pocock/routes/wayfinder.md +27 -0
- package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +74 -185
- package/template/workflows/person/M-mao-zedong-cognitive-os/activate.md +3 -2
- package/template/workflows/person/M-mao-zedong-cognitive-os/books/README.md +12 -238
- package/template/workflows/person/M-mao-zedong-cognitive-os/deliver.md +6 -5
- package/template/workflows/person/M-mao-zedong-cognitive-os/diagnose.md +5 -63
- package/template/workflows/person/M-mao-zedong-cognitive-os/mobilize.md +7 -54
- package/template/workflows/person/M-mao-zedong-cognitive-os/references/research/15-quote-bank.md +10 -10
- package/template/workflows/person/M-mao-zedong-cognitive-os/strategize.md +6 -72
- package/template/workflows/person/WORKFLOW.md +68 -0
- package/template/workflows/person/_state/.config/LESSONS.md +3 -0
- package/template/workflows/person/_state/.config/RULES.md +3 -0
- package/template/workflows/person/_state/changes/.gitkeep +1 -0
- package/template/workflows/person/_state/status.json +5 -0
- package/template/.speculo/.config/LESSONS.md +0 -9
- package/template/.speculo/.config/RULES.md +0 -11
- package/template/.speculo/AGENTS.md +0 -30
- package/template/.speculo/archive/AGENTS.md +0 -28
- package/template/.speculo/archive/dev/.gitkeep +0 -0
- package/template/.speculo/archive/person/.gitkeep +0 -0
- package/template/.speculo/dev/.gitkeep +0 -0
- package/template/.speculo/dev/docs-sync-state.json +0 -14
- package/template/.speculo/dev-status.json +0 -3
- package/template/.speculo/doc-status.json +0 -3
- package/template/.speculo/person/.gitkeep +0 -0
- package/template/.speculo/person-status.json +0 -1
- package/template/commands/archive.md +0 -68
- package/template/commands/caveman.md +0 -50
- package/template/commands/config-prune.md +0 -59
- package/template/commands/grill-me.md +0 -48
- package/template/commands/handoff.md +0 -59
- package/template/commands/scaffold-exercises.md +0 -56
- package/template/commands/write-a-skill.md +0 -52
- package/template/skills/caveman/SKILL.md +0 -38
- package/template/skills/caveman/references/compression-rules.md +0 -102
- package/template/skills/config-prune/SKILL.md +0 -66
- package/template/skills/grill-me/SKILL.md +0 -40
- package/template/skills/handoff/SKILL.md +0 -50
- package/template/skills/scaffold-exercises/SKILL.md +0 -41
- package/template/skills/scaffold-exercises/references/exercise-structure.md +0 -85
- package/template/skills/scaffold-exercises/references/lint-and-git.md +0 -54
- package/template/skills/speculo-write/SKILL.md +0 -56
- package/template/skills/speculo-write/references/asset-selection-sop.md +0 -67
- package/template/skills/speculo-write/references/authoring-quality-levers.md +0 -61
- package/template/skills/speculo-write/references/command-authoring-sop.md +0 -98
- package/template/skills/speculo-write/references/migration-sop.md +0 -101
- package/template/skills/speculo-write/references/persistence-contract-sop.md +0 -192
- package/template/skills/speculo-write/references/skill-authoring-sop.md +0 -212
- package/template/skills/speculo-write/references/validation-checklist.md +0 -85
- package/template/skills/speculo-write/references/workflow-authoring-sop.md +0 -132
- package/template/vendor/codebase-design/DEEPENING.md +0 -37
- package/template/vendor/codebase-design/DESIGN-IT-TWICE.md +0 -44
- package/template/vendor/codebase-design/SKILL.md +0 -114
- package/template/vendor/officecli/SKILL.md +0 -415
- package/template/vendor/resolving-merge-conflicts/SKILL.md +0 -14
- package/template/workflows/dev/01-grill-with-docs/01-grill-with-docs.md +0 -107
- package/template/workflows/dev/01-grill-with-docs/grill-context-scan.md +0 -30
- package/template/workflows/dev/01-grill-with-docs/grill-decision.md +0 -38
- package/template/workflows/dev/02-prd/02-prd.md +0 -70
- package/template/workflows/dev/02-prd/prd-synthesis.md +0 -30
- package/template/workflows/dev/02-prd/prd-zoom-out.md +0 -29
- package/template/workflows/dev/03-tdd/03-tdd.md +0 -158
- package/template/workflows/dev/03-tdd/mocking.md +0 -43
- package/template/workflows/dev/03-tdd/refactoring.md +0 -10
- package/template/workflows/dev/03-tdd/tdd-finish.md +0 -34
- package/template/workflows/dev/03-tdd/tdd-loop.md +0 -36
- package/template/workflows/dev/03-tdd/tdd-plan.md +0 -37
- package/template/workflows/dev/03-tdd/tests.md +0 -61
- package/template/workflows/dev/04-finalize/04-finalize.md +0 -137
- package/template/workflows/dev/04-finalize/completion-gate.md +0 -41
- package/template/workflows/dev/04-finalize/finalize-archive.md +0 -55
- package/template/workflows/dev/A-improve-architecture/A-improve-architecture.md +0 -143
- package/template/workflows/dev/A-improve-architecture/HTML-REPORT.md +0 -123
- package/template/workflows/dev/AGENTS.md +0 -87
- package/template/workflows/dev/D-docs-sync/D-docs-sync.md +0 -127
- package/template/workflows/dev/D-docs-sync/agents-contract.md +0 -95
- package/template/workflows/dev/D-docs-sync/changelog-contract.md +0 -155
- package/template/workflows/dev/D-docs-sync/config-contract.md +0 -75
- package/template/workflows/dev/D-docs-sync/docs-sync-diff.md +0 -86
- package/template/workflows/dev/D-docs-sync/docs-sync-finish.md +0 -37
- package/template/workflows/dev/D-docs-sync/docs-sync-state.md +0 -47
- package/template/workflows/dev/D-docs-sync/docs-sync-update.md +0 -44
- package/template/workflows/dev/D-docs-sync/knowledge-extract.md +0 -66
- package/template/workflows/dev/D-docs-sync/readme-contract.md +0 -124
- package/template/workflows/dev/D-docs-sync/state-json-schema.md +0 -172
- package/template/workflows/dev/H-diagnose/H-diagnose.md +0 -119
- package/template/workflows/dev/H-diagnose/diagnose-fix.md +0 -34
- package/template/workflows/dev/H-diagnose/diagnose-guide.md +0 -144
- package/template/workflows/dev/H-diagnose/diagnose-loop.md +0 -41
- package/template/workflows/dev/H-diagnose/scripts/hitl-loop.template.sh +0 -41
- package/template/workflows/dev/I-to-issues/I-to-issues.md +0 -140
- package/template/workflows/dev/I-to-issues/issues-slices.md +0 -211
- package/template/workflows/dev/M-domain-modeling/ADR-FORMAT.md +0 -74
- package/template/workflows/dev/M-domain-modeling/CONTEXT-FORMAT.md +0 -67
- package/template/workflows/dev/M-domain-modeling/M-domain-modeling.md +0 -118
- package/template/workflows/dev/R-review/R-review.md +0 -163
- package/template/workflows/dev/R-review/code-quality-checklist.md +0 -118
- package/template/workflows/dev/R-review/removal-checklist.md +0 -53
- package/template/workflows/dev/R-review/review-axes.md +0 -61
- package/template/workflows/dev/R-review/review-setup.md +0 -73
- package/template/workflows/dev/R-review/review-verdict.md +0 -43
- package/template/workflows/dev/R-review/security-checklist.md +0 -126
- package/template/workflows/dev/R-review/solid-checklist.md +0 -73
- package/template/workflows/dev/_templates/diagnosis-template.md +0 -20
- package/template/workflows/dev/_templates/docs-sync-report-template.md +0 -45
- package/template/workflows/dev/_templates/docs-sync-state-template.json +0 -14
- package/template/workflows/dev/_templates/domain-model-log-template.md +0 -20
- package/template/workflows/dev/_templates/grill-context-map-template.md +0 -20
- package/template/workflows/dev/_templates/grill-decision-log-template.md +0 -20
- package/template/workflows/dev/_templates/issues-slices-template.md +0 -106
- package/template/workflows/dev/_templates/prd-overview-template.md +0 -20
- package/template/workflows/dev/_templates/prd-template.md +0 -26
- package/template/workflows/dev/_templates/regression-template.md +0 -20
- package/template/workflows/dev/_templates/review-report-template.md +0 -30
- package/template/workflows/dev/_templates/review-sources-template.md +0 -33
- package/template/workflows/dev/_templates/review-verdict-template.md +0 -33
- package/template/workflows/dev/_templates/tdd-log-template.md +0 -23
- package/template/workflows/dev/_templates/tdd-plan-template.md +0 -35
- package/template/workflows/dev/_templates/tdd-verification-template.md +0 -26
- package/template/workflows/doc/AGENTS.md +0 -72
- package/template/workflows/doc/B-writing-beats/B-writing-beats.md +0 -79
- package/template/workflows/doc/B-writing-beats/writing-beats-append.md +0 -31
- package/template/workflows/doc/B-writing-beats/writing-beats-options.md +0 -29
- package/template/workflows/doc/E-edit-article/E-edit-article.md +0 -79
- package/template/workflows/doc/E-edit-article/edit-article-plan.md +0 -30
- package/template/workflows/doc/E-edit-article/edit-article-rewrite.md +0 -31
- package/template/workflows/doc/F-writing-fragments/F-writing-fragments.md +0 -80
- package/template/workflows/doc/F-writing-fragments/writing-fragments-interview.md +0 -32
- package/template/workflows/doc/F-writing-fragments/writing-fragments-log.md +0 -29
- package/template/workflows/doc/S-writing-shape/S-writing-shape.md +0 -81
- package/template/workflows/doc/S-writing-shape/writing-shape-block.md +0 -32
- package/template/workflows/doc/S-writing-shape/writing-shape-opening.md +0 -27
- package/template/workflows/doc/T-teach/T-teach.md +0 -147
- package/template/workflows/doc/T-teach/teach-lesson-wrap.md +0 -63
- package/template/workflows/doc/T-teach/teach-lesson.md +0 -53
- package/template/workflows/doc/T-teach/teach-mission.md +0 -33
- package/template/workflows/doc/T-teach/teach-resources.md +0 -36
- package/template/workflows/doc/_templates/edit-article-plan-template.md +0 -25
- package/template/workflows/doc/_templates/edit-article-template.md +0 -7
- package/template/workflows/doc/_templates/teach-glossary-template.md +0 -26
- package/template/workflows/doc/_templates/teach-learning-record-template.md +0 -38
- package/template/workflows/doc/_templates/teach-mission-template.md +0 -19
- package/template/workflows/doc/_templates/teach-resources-template.md +0 -18
- package/template/workflows/doc/_templates/writing-article-template.md +0 -7
- package/template/workflows/doc/_templates/writing-beat-options-template.md +0 -21
- package/template/workflows/doc/_templates/writing-fragments-template.md +0 -7
- package/template/workflows/doc/_templates/writing-interview-log-template.md +0 -21
- package/template/workflows/doc/_templates/writing-shape-log-template.md +0 -25
- package/template/workflows/person/AGENTS.md +0 -60
- /package/template/{.speculo/.config/adr → workflows/matt-pocock/_state/archive}/.gitkeep +0 -0
- /package/template/{.speculo/.config/context → workflows/matt-pocock/_state/changes}/.gitkeep +0 -0
- /package/template/{.speculo/archive/doc → workflows/person/_state/.config/context}/.gitkeep +0 -0
- /package/template/{.speculo/doc → workflows/person/_state/archive}/.gitkeep +0 -0
|
@@ -2,77 +2,19 @@
|
|
|
2
2
|
|
|
3
3
|
## 输入
|
|
4
4
|
|
|
5
|
-
- `speculo/.speculo/person/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
-
- Module A
|
|
5
|
+
- `speculo/.speculo/person/changes/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
+
- Module A 模型清单与展开规则:`references/research/11-analysis-frameworks.md`
|
|
7
|
+
- 引语与篇目映射:`references/research/15-quote-bank.md`(查原文前先读)
|
|
7
8
|
|
|
8
9
|
## 产物
|
|
9
10
|
|
|
10
|
-
- `speculo/.speculo/person/<change>/analysis.md`
|
|
11
|
+
- `speculo/.speculo/person/changes/<change>/analysis.md`
|
|
11
12
|
|
|
12
13
|
## 认知主线
|
|
13
14
|
|
|
14
15
|
**事实 → 矛盾 → 主次 → 定性 → 两面 → 条件 → 本质 → 具体 → 检验。**
|
|
15
16
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
### A1 · 矛盾分析法(主算法)
|
|
19
|
-
来源:《矛盾论》(017)
|
|
20
|
-
|
|
21
|
-
一句话:找到主要矛盾,就找到破局之道。
|
|
22
|
-
|
|
23
|
-
四个子工具:
|
|
24
|
-
1. **普遍性 vs 特殊性**:"这个矛盾特殊在哪?"
|
|
25
|
-
2. **主要矛盾 vs 次要矛盾**:"哪个一解决,其余迎刃而解?"
|
|
26
|
-
3. **矛盾的主要方面 vs 次要方面**:"现在哪一方在支配?据此定性"
|
|
27
|
-
4. **同一性与斗争性**:"逆转需要哪些条件?现在具备几个?"
|
|
28
|
-
|
|
29
|
-
原话:"捉住了这个主要矛盾,一切问题就迎刃而解了。"
|
|
30
|
-
局限:信息不足时易误判主要矛盾。
|
|
31
|
-
|
|
32
|
-
### A2 · 实践认识论
|
|
33
|
-
来源:《实践论》(016)
|
|
34
|
-
|
|
35
|
-
一句话:认识从实践来,经理论提升,回到实践验证,循环往复、螺旋上升。
|
|
36
|
-
原话:"你要知道梨子的滋味,你就得变革梨子,亲口吃一吃。"
|
|
37
|
-
局限:试错成本极高的领域(医疗、航天)需先充分理论推演。
|
|
38
|
-
|
|
39
|
-
### A3 · 调查研究方法论
|
|
40
|
-
来源:《反对本本主义》(006)、《〈农村调查〉的序言和跋》(058)
|
|
41
|
-
|
|
42
|
-
一句话:没有调查,没有发言权。
|
|
43
|
-
工序:选典型 → 选真正有经验的人 → 定纲目 → 开调查会 → 眼睛向下、口问手写。
|
|
44
|
-
局限:调查也得讲方法,"不做正确的调查同样没有发言权"。
|
|
45
|
-
|
|
46
|
-
### A4 · 实事求是
|
|
47
|
-
来源:《改造我们的学习》(059)、《整顿党的作风》(063)
|
|
48
|
-
|
|
49
|
-
一句话:一切从客观事实出发,从事物内部规律引出结论,"有的放矢"。
|
|
50
|
-
检查清单:判断从事实还是从愿望/本本出发?是否详细占有材料?结论是否从内部联系引出?
|
|
51
|
-
|
|
52
|
-
### A5 · 一分为二(两点论 + 重点论)
|
|
53
|
-
来源:《矛盾论》(017);《关于正确处理人民内部矛盾的问题》(216)
|
|
54
|
-
|
|
55
|
-
一句话:任何事物都有两面,但两点之中又有重点。
|
|
56
|
-
动作:拿到任何判断先反问"它的反面是什么?"——这是避免片面化的安全阀。
|
|
57
|
-
|
|
58
|
-
### A6 · 阶级 / 结构分析
|
|
59
|
-
来源:《中国社会各阶级的分析》(000)、《怎样分析农村阶级》(008)
|
|
60
|
-
|
|
61
|
-
一句话:把局面拆成力量结构——分清敌/友/中间。
|
|
62
|
-
动作:分层 → 判定各方态度 → 找最广同盟 → 盯住摇摆者 → 团结多数、孤立主敌。
|
|
63
|
-
现代应用须中性化为"利益相关方/力量结构分析"。
|
|
64
|
-
|
|
65
|
-
### A7 · 透过现象看本质
|
|
66
|
-
来源:《星星之火,可以燎原》(005)
|
|
67
|
-
|
|
68
|
-
一句话:"看它的实质,而把它的现象只看作入门的向导,一进了门就要抓住它的实质。"
|
|
69
|
-
判断真假强弱不看表面力量,看是否得人心、是否代表进步方向。
|
|
70
|
-
|
|
71
|
-
### A8 · 具体问题具体分析
|
|
72
|
-
来源:《中国革命战争的战略问题》(012)、《矛盾论》(017)
|
|
73
|
-
|
|
74
|
-
一句话:不同质的矛盾,用不同质的方法解决,反对一刀切照搬。
|
|
75
|
-
套用任何通用模型前先问三问:现在是哪个阶段?这个对象特殊在哪?不能照搬什么?
|
|
17
|
+
Module A 八模型清单、子工具与局限见 `references/research/11-analysis-frameworks.md`;展开某模型时按编号查 `references/research/15-quote-bank.md` 再开 `books/src/NNN-*.md`。
|
|
76
18
|
|
|
77
19
|
## 填写引导
|
|
78
20
|
|
|
@@ -2,68 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
## 输入
|
|
4
4
|
|
|
5
|
-
- `speculo/.speculo/person/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
-
- `speculo/.speculo/person/<change>/analysis.md`(Phase 2 产物)
|
|
7
|
-
- `speculo/.speculo/person/<change>/strategy.md`(Phase 3 产物)
|
|
5
|
+
- `speculo/.speculo/person/changes/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
+
- `speculo/.speculo/person/changes/<change>/analysis.md`(Phase 2 产物)
|
|
7
|
+
- `speculo/.speculo/person/changes/<change>/strategy.md`(Phase 3 产物)
|
|
8
|
+
- Module C 方法清单与操作手册:`references/research/13-organization-action.md`
|
|
9
|
+
- 引语与篇目映射:`references/research/15-quote-bank.md`
|
|
8
10
|
|
|
9
11
|
## 产物
|
|
10
12
|
|
|
11
|
-
- `speculo/.speculo/person/<change>/action-plan.md`
|
|
13
|
+
- `speculo/.speculo/person/changes/<change>/action-plan.md`
|
|
12
14
|
|
|
13
15
|
## 核心命题
|
|
14
16
|
|
|
15
17
|
> "正确的路线确定之后,干部就是决定的因素。"
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
## Module C · 8 大组织方法
|
|
20
|
-
|
|
21
|
-
### C1 · 群众路线
|
|
22
|
-
来源:《关于领导方法的若干问题》(070)、《组织起来》(074)
|
|
23
|
-
|
|
24
|
-
从群众中来,到群众中去:把分散意见**集中** → 回群众中**坚持** → 群众行动中**检验** → 再集中、再坚持,无限循环。
|
|
25
|
-
配套:一般号召 + 个别指导;领导骨干 + 广大群众。
|
|
26
|
-
|
|
27
|
-
### C2 · 批评与自我批评
|
|
28
|
-
来源:《组织起来》(074)、《为人民服务》(076)
|
|
29
|
-
|
|
30
|
-
组织的免疫系统,日常"洗脸扫地"。
|
|
31
|
-
原则:治病救人而非打死人;闻过则喜;大多数是好同志。
|
|
32
|
-
|
|
33
|
-
### C3 · 整风与思想建设
|
|
34
|
-
来源:《整顿党的作风》(063)、《反对党八股》(064)、《反对自由主义》(020)
|
|
35
|
-
|
|
36
|
-
三维一体治理:反主观主义(学风)/ 反宗派主义(党风)/ 反党八股(文风)。
|
|
37
|
-
"马克思列宁主义和中国革命的关系,就是箭和靶的关系"——有的放矢。
|
|
38
|
-
|
|
39
|
-
### C4 · 民主集中制
|
|
40
|
-
来源:《关于健全党委制》(129)
|
|
41
|
-
|
|
42
|
-
民主基础上的集中,集中指导下的民主。
|
|
43
|
-
四个服从:个人服从组织、少数服从多数、下级服从上级、全党服从中央。
|
|
44
|
-
|
|
45
|
-
### C5 · 党委会工作方法(12 条)
|
|
46
|
-
来源:《党委会的工作方法》(147)
|
|
47
|
-
|
|
48
|
-
书记要善于当"班长"。十二条 checklist:
|
|
49
|
-
1. 当班长 2. 把问题摆到桌面上 3. 互通情报 4. 不懂就问·不耻下问 5. 弹钢琴(抓中心又兼顾全面)6. 抓紧("抓而不紧,等于不抓")7. 胸中有数 8. 安民告示 9. 精兵简政 10. 团结持不同意见的人 11. 力戒骄傲 12. 划清两种界限。
|
|
50
|
-
|
|
51
|
-
### C6 · 用人与带队伍
|
|
52
|
-
来源:《井冈山的斗争》(003)、《关于纠正党内的错误思想》(004)
|
|
53
|
-
|
|
54
|
-
支部建在连上(组织建到最小作战单元);德才兼备;骨干随斗争阶段不断更新。
|
|
55
|
-
|
|
56
|
-
### C7 · 执行学(桥与船)
|
|
57
|
-
来源:《关心群众生活,注意工作方法》(010)
|
|
58
|
-
|
|
59
|
-
任务必配方法:"不解决桥或船的问题,过河就是一句空话。"
|
|
60
|
-
一定时间内只能有一个中心工作。执行力的根本来源是群众真心拥护。
|
|
61
|
-
|
|
62
|
-
### C8 · 纪律(三大纪律八项注意)
|
|
63
|
-
来源:《重行颁布三大纪律八项注意的训令》(111);《〈共产党人〉发刊词》(037)
|
|
64
|
-
|
|
65
|
-
把抽象的"人民性"落实为可执行、可检查的纪律条款。
|
|
66
|
-
三大法宝锚点:统一战线、武装斗争、党的建设。
|
|
19
|
+
Module C 八方法清单与党委会 12 条见 `references/research/13-organization-action.md`。
|
|
67
20
|
|
|
68
21
|
## 填写引导
|
|
69
22
|
|
package/template/workflows/person/M-mao-zedong-cognitive-os/references/research/15-quote-bank.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 15 · 引语库与原文索引(Quote Bank & Source Index)
|
|
2
2
|
|
|
3
|
-
> 维度定位:本文件是 **mao-zedong-cognitive-os**
|
|
4
|
-
> 用途:当
|
|
3
|
+
> 维度定位:本文件是 **M-mao-zedong-cognitive-os** workflow 的「引语底座」与「原文检索映射表」。
|
|
4
|
+
> 用途:当 workflow 需要在对话中**引用原文金句**、或需要**回溯到《毛泽东选集》原文篇目**核对/扩展时,先查本文件。
|
|
5
5
|
> 检索约定:原文出自本工作流内置知识库 `books/src/NNN-标题.md`(编号 000–228)。本文所有「篇目编号」均指该编号。查不到或拿不准的引语,到 `books/src/` 目录读取原文查证,**严禁杜撰**。
|
|
6
6
|
> 边界声明:本文件聚焦**思维方法论与表达风格**。凡涉及 1949 年后政策后果、运动执行、政治立场等争议,仅在「方法论层面」中性引用,并在相关条目标注边界。所有引语严格来自研究素材,不臆造出处;个别口语化金句注明「转述/回忆录来源」。
|
|
7
7
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
| 想找某篇文章的编号去读原文 | 查 **第 5 节·篇目编号速查表(按主题聚类)** |
|
|
18
18
|
| 想要"开场/收尾/反问"对话动作的句式 | 查 **第 6 节·对话动作引语模板** |
|
|
19
19
|
|
|
20
|
-
**引用纪律(
|
|
20
|
+
**引用纪律(workflow 必须遵守)**:
|
|
21
21
|
1. 引用金句必须带篇目名;能给编号的给编号(如 `《矛盾论》(017)`)。
|
|
22
22
|
2. 区分"逐字原文"与"概括转述"——前者加引号,后者不加。
|
|
23
23
|
3. 涉及建国后争议史,只引方法论层面的句子,附边界提示。
|
|
@@ -39,7 +39,7 @@
|
|
|
39
39
|
| 幽默讽刺 | 幽默来自辩证法,能一眼看到事物反面 | "帝国主义是纸老虎。"——《和美国记者安娜·路易斯·斯特朗的谈话》(101) |
|
|
40
40
|
| 谦虚好学+终身学习 | 嗜书如命、甘当小学生 | "群众是真正的英雄,而我们自己则往往是幼稚可笑的。"——《〈农村调查〉的序言和跋》(058) |
|
|
41
41
|
|
|
42
|
-
> 边界:关于"权力敏感/情绪操控/晚年变化"等评价(多来自李志绥回忆录等),学术界争议大,**本
|
|
42
|
+
> 边界:关于"权力敏感/情绪操控/晚年变化"等评价(多来自李志绥回忆录等),学术界争议大,**本 workflow 不采用**作为语气来源,仅作存在性标注。
|
|
43
43
|
|
|
44
44
|
---
|
|
45
45
|
|
|
@@ -150,13 +150,13 @@
|
|
|
150
150
|
| 老鼠过街,人人喊打。 | 《反对党八股》(064) | 谚语·群众语言 |
|
|
151
151
|
| 自由主义……是一种腐蚀剂,使团结涣散,关系松懈,工作消极,意见分歧。 | 《反对自由主义》(020) | 化学比喻·危害 |
|
|
152
152
|
|
|
153
|
-
> 语言操作要点(供
|
|
153
|
+
> 语言操作要点(供 workflow 行文风格):①优先用身体化/生活化比喻把抽象讲通俗;②善用排比列举(八大罪状、十一种表现)形成论证链;③反问启动读者推演;④"说话要有趣味"(1929《教授法》第六条,转述来源:新湘评论)。
|
|
154
154
|
|
|
155
155
|
---
|
|
156
156
|
|
|
157
157
|
## 3 · 心智模型 / 战略框架 → 篇目编号映射表
|
|
158
158
|
|
|
159
|
-
> 用途:从认知操作系统的"模型组件"反查原文出处。
|
|
159
|
+
> 用途:从认知操作系统的"模型组件"反查原文出处。workflow 调用某模型时,可据此读取原文加深论证。
|
|
160
160
|
|
|
161
161
|
### 3.1 七大核心分析模型
|
|
162
162
|
|
|
@@ -231,7 +231,7 @@
|
|
|
231
231
|
|
|
232
232
|
## 4 · 决策启发式(Heuristics)→ 篇目编号映射表
|
|
233
233
|
|
|
234
|
-
> 用途:
|
|
234
|
+
> 用途:workflow 给出"用毛泽东方式判断"的行动建议时,可据此回溯原文依据并直引佐证句。
|
|
235
235
|
|
|
236
236
|
| # | 决策启发式(行动准则) | 原文依据篇目(编号) | 可直引佐证句 |
|
|
237
237
|
|---|---|---|---|
|
|
@@ -273,7 +273,7 @@
|
|
|
273
273
|
|
|
274
274
|
## 5 · 篇目编号速查表(按主题聚类 · 仅列素材覆盖篇目)
|
|
275
275
|
|
|
276
|
-
> 此表是
|
|
276
|
+
> 此表是 workflow "读原文"的入口。按聚类组织,方便从主题快速定位文件名 `NNN-标题.md`。
|
|
277
277
|
|
|
278
278
|
### 哲学方法论
|
|
279
279
|
- 006 反对本本主义
|
|
@@ -350,7 +350,7 @@
|
|
|
350
350
|
|
|
351
351
|
---
|
|
352
352
|
|
|
353
|
-
## 6 · 对话动作引语模板(供
|
|
353
|
+
## 6 · 对话动作引语模板(供 workflow 在对话中调用)
|
|
354
354
|
|
|
355
355
|
> 把引语包装成"可执行的对话动作"。每个动作=触发场景+推荐金句+话术骨架。
|
|
356
356
|
|
|
@@ -401,4 +401,4 @@
|
|
|
401
401
|
| 诗词意象(宜将剩勇追穷寇等) | 标注为诗词,作风格佐证,非政策论据 |
|
|
402
402
|
| 西方学界评价(Schram/Schwartz/纸老虎商业类比) | 仅作"外部影响"背景,不作毛本人原意;商业"农村包围城市"类比为当代回溯解读,非毛本人提法 |
|
|
403
403
|
|
|
404
|
-
**
|
|
404
|
+
**workflow 使用总则**:本引语库服务于**思维方法迁移**(战略分析、组织管理、问题诊断),不充当任何具体政治立场的论据。引用建国后争议文本时,只取其"矛盾论/两点论/调查研究/群众路线"等方法论内核,并保持中性。
|
|
@@ -2,86 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
## 输入
|
|
4
4
|
|
|
5
|
-
- `speculo/.speculo/person/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
-
- `speculo/.speculo/person/<change>/analysis.md`(Phase 2 产物)
|
|
5
|
+
- `speculo/.speculo/person/changes/<change>/problem-statement.md`(Phase 1 产物)
|
|
6
|
+
- `speculo/.speculo/person/changes/<change>/analysis.md`(Phase 2 产物)
|
|
7
|
+
- Module B 框架清单与决策树:`references/research/12-strategy-frameworks.md`
|
|
8
|
+
- 引语与篇目映射:`references/research/15-quote-bank.md`
|
|
7
9
|
|
|
8
10
|
## 产物
|
|
9
11
|
|
|
10
|
-
- `speculo/.speculo/person/<change>/strategy.md`
|
|
12
|
+
- `speculo/.speculo/person/changes/<change>/strategy.md`
|
|
11
13
|
|
|
12
14
|
## 元框架(战略流水线)
|
|
13
15
|
|
|
14
16
|
**定性(敌我力量本质)→ 定向(主要矛盾)→ 站位(敌我友)→ 时间(阶段/节奏)→ 投放(集中一点)→ 运用(保持主动)。**
|
|
15
17
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
## Module B · 8 大战略框架
|
|
19
|
-
|
|
20
|
-
### 战略快速选择表(情境 → 框架)
|
|
21
|
-
|
|
22
|
-
| 你面临的情境 | 调用框架 | 一句话动作 |
|
|
23
|
-
|------------|---------|-----------|
|
|
24
|
-
| 敌强我弱、短期无法取胜 | B1 持久战 | 用时间换空间,熬过相持期 |
|
|
25
|
-
| 对手主场强大,正面打不过 | B2 农村包围城市 | 从边缘做实,建稳固根据地 |
|
|
26
|
-
| 总体劣势但想打赢局部 | B3 集中优势兵力 | 集中 3–4 倍兵力歼灭一支 |
|
|
27
|
-
| 力量不足需借力 | B4 统一战线 | 团结朋友、争取中间、孤立主敌 |
|
|
28
|
-
| 被强敌吓住 / 盲目轻敌 | B5 纸老虎论 | 战略藐视 + 战术重视 |
|
|
29
|
-
| 被对手牵着走,丧失节奏 | B6 运动战 | 灵活机动,弱点变优势 |
|
|
30
|
-
| 寄望外援 / 靠天吃饭 | B7 自力更生 | 立足自身,外因通过内因 |
|
|
31
|
-
| 多线作战、斗争失控风险 | B8 有理有利有节 | 不树敌太多,斗争有边界 |
|
|
32
|
-
|
|
33
|
-
### B1 · 持久战三阶段论
|
|
34
|
-
来源:《论持久战》(026)
|
|
35
|
-
|
|
36
|
-
敌强我弱、无法速胜时,用时间换空间:战略防御 → 战略相持(最艰苦、最关键)→ 战略反攻。
|
|
37
|
-
前提是"进步、多助、地大人多"。"兵民是胜利之本。"
|
|
38
|
-
局限:前提是正义方+有根据地;基本面恶化时拖延只会更糟。
|
|
39
|
-
|
|
40
|
-
### B2 · 农村包围城市 / 根据地战略
|
|
41
|
-
来源:《星星之火,可以燎原》(005)、《井冈山的斗争》(003)
|
|
42
|
-
|
|
43
|
-
避敌之强、攻敌之弱,从边缘做实,建稳固根据地。
|
|
44
|
-
根据地三要素:好群众 + 好组织 + 相当力量的正式武装。
|
|
45
|
-
警惕"流寇主义"——只游击不建根据地必死。
|
|
46
|
-
局限:有时"城市"确是关键制高点,需判断何时该打城市。
|
|
47
|
-
|
|
48
|
-
### B3 · 集中优势兵力,各个歼灭
|
|
49
|
-
来源:《集中优势兵力,各个歼灭敌人》(102)、《井冈山的斗争》(003)
|
|
50
|
-
|
|
51
|
-
不平分兵力,局部造我强敌弱(3–4 倍),逐个歼灭敌人有生力量。
|
|
52
|
-
"分兵几乎没有一次不失败。""敌人有十个牙齿,应该敲掉一个牙齿再敲一个。"
|
|
53
|
-
|
|
54
|
-
### B4 · 统一战线(分清敌我友 / 又团结又斗争)
|
|
55
|
-
来源:《中国社会各阶级的分析》(000)、《统一战线中的独立自主问题》(028)、《论政策》(054)
|
|
56
|
-
|
|
57
|
-
团结真朋友、争取中间、孤立主敌;联盟内既合作又斗争,保持独立自主。
|
|
58
|
-
两原则:"第一个是团结,第二个是批评、教育和改造。"
|
|
59
|
-
局限:联盟脆弱,主要矛盾一变盟友可能翻脸。
|
|
60
|
-
|
|
61
|
-
### B5 · 纸老虎论(战略藐视 / 战术重视)
|
|
62
|
-
来源:《一切反动派都是纸老虎》(228)、《和美国记者斯特朗的谈话》(101)
|
|
63
|
-
|
|
64
|
-
对强敌做二重性判断:战略上藐视(脱离人民者必衰),战术上重视(当下有爪有牙)。
|
|
65
|
-
只藐视不重视=冒险主义;只重视不藐视=机会主义。
|
|
66
|
-
局限:误把真老虎当纸老虎,后果严重。
|
|
67
|
-
|
|
68
|
-
### B6 · 运动战与争取主动权
|
|
69
|
-
来源:《抗日游击战争的战略问题》(025)
|
|
70
|
-
|
|
71
|
-
灵活机动调动敌人、化弱为强。"敌进我退,敌驻我扰,敌疲我打,敌退我追。"
|
|
72
|
-
主动权来自正确的情况估计 + 正确的处置。
|
|
73
|
-
|
|
74
|
-
### B7 · 自力更生为主
|
|
75
|
-
来源:《矛盾论》(017·内外因)、《愚公移山》(083)
|
|
76
|
-
|
|
77
|
-
立足自身力量,外援为辅。"内因是变化的根据,外因是变化的条件,外因通过内因而起作用。"
|
|
78
|
-
力量来自动员自身的人民,不押宝于外部善意。
|
|
79
|
-
|
|
80
|
-
### B8 · 有理有利有节(斗争节制)
|
|
81
|
-
来源:《不要四面出击》(165)、《关于正确处理人民内部矛盾的问题》(216)
|
|
82
|
-
|
|
83
|
-
不树敌太多、不四面出击,集中打主敌,对次要对手有所让步缓和。
|
|
84
|
-
区分两类矛盾:敌我矛盾(专政)vs 人民内部矛盾(民主、说服、"团结—批评—团结")。
|
|
18
|
+
Module B 八框架清单、情境选择表与适用条件见 `references/research/12-strategy-frameworks.md`。
|
|
85
19
|
|
|
86
20
|
## 填写引导
|
|
87
21
|
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: person
|
|
3
|
+
type: workflow
|
|
4
|
+
workflow: person
|
|
5
|
+
name: Person Workflow
|
|
6
|
+
description: 以人物方法论为底座的显式激活型咨询 workflow
|
|
7
|
+
keywords: [person, methodology, consulting, 人物, 方法论]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Person Workflow
|
|
11
|
+
|
|
12
|
+
先读取项目根 `speculo/.speculo/workspace.json`,再解析以下 workflow/state 根。进入时读取 `status.json`,选择唯一 active change;没有 active change 时原子创建 `changes/<YYYY-MM-DD-name>/.status.json` 并追加索引。
|
|
13
|
+
|
|
14
|
+
## 运行时根
|
|
15
|
+
|
|
16
|
+
```xml
|
|
17
|
+
<runtime-context>
|
|
18
|
+
<root id="workflow" base="workflows" path="person" />
|
|
19
|
+
<root id="state" base="state" path="person" />
|
|
20
|
+
</runtime-context>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 持久化命名空间
|
|
24
|
+
|
|
25
|
+
```xml
|
|
26
|
+
<persistence root="state">
|
|
27
|
+
<store id="index" role="index" kind="file" path="status.json" create="initialize" />
|
|
28
|
+
<store id="changes" role="active" kind="directory" path="changes" create="initialize" />
|
|
29
|
+
<store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
|
|
30
|
+
<store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
|
|
31
|
+
</persistence>
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## 路由
|
|
35
|
+
|
|
36
|
+
```xml
|
|
37
|
+
<routes>
|
|
38
|
+
<route id="mao-zedong-cognitive-os" order="1" root="workflow" path="M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md">
|
|
39
|
+
<when>用户希望以毛泽东方法论分析问题、制定战略或组织行动。</when>
|
|
40
|
+
</route>
|
|
41
|
+
</routes>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## 依赖
|
|
45
|
+
|
|
46
|
+
```xml
|
|
47
|
+
<dependencies />
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## 状态扩展字段
|
|
51
|
+
|
|
52
|
+
```xml
|
|
53
|
+
<state-schema>
|
|
54
|
+
<field name="current_route" type="string" />
|
|
55
|
+
<field name="route_history" type="array" />
|
|
56
|
+
</state-schema>
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## 状态转移
|
|
60
|
+
|
|
61
|
+
```xml
|
|
62
|
+
<transitions>
|
|
63
|
+
<transition from="active" to="archived">
|
|
64
|
+
<command root="commands" path="finalize.md" />
|
|
65
|
+
<when>用户确认咨询交付完成且完成门禁通过。</when>
|
|
66
|
+
</transition>
|
|
67
|
+
</transitions>
|
|
68
|
+
```
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
# Project Rules
|
|
2
|
-
|
|
3
|
-
记录跨所有 Speculo workflow 必须遵守的项目硬约束。
|
|
4
|
-
|
|
5
|
-
本文件由用户维护。AI 可以读取并遵守,但不得自动修改,除非用户明确要求。
|
|
6
|
-
|
|
7
|
-
## Rules
|
|
8
|
-
|
|
9
|
-
- **Rule 0 — 持久化铁律:所有 Speculo workflow、command、skill 的输出和持久化内容,必须且只能存放在 `speculo/.speculo/` 目录中。绝对禁止写入 `temp/`、系统临时目录、项目根目录的 `.speculo/` 或其他任何非规范位置。**
|
|
10
|
-
- 所有 Speculo change 目录必须以 `YYYY-MM-DD-<kebab-name>` 命名(例:`2026-06-12-user-auth`)。
|
|
11
|
-
- 所有 Speculo command 产物目录必须以 `YYYY-MM-DD-<cmd-name>-<topic>` 命名。
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
# Speculo State AGENTS Guide
|
|
2
|
-
|
|
3
|
-
本目录是 Speculo 运行时状态、项目知识和归档的唯一持久化根目录。所有 workflow、command 和 skill 调用方写入的持久化产物必须留在 `speculo/.speculo/` 内。
|
|
4
|
-
|
|
5
|
-
## 读取顺序
|
|
6
|
-
|
|
7
|
-
1. 先读目标分类索引:`dev-status.json`、`doc-status.json` 或 `person-status.json`。
|
|
8
|
-
2. 再按 active 条目读取对应 change 的 `.status.json`:`<cat>/<change>/.status.json`。
|
|
9
|
-
3. 需要 workflow 产物时,只读取当前 change 目录下与当前 phase 相关的文件。
|
|
10
|
-
4. 需要历史上下文时,读取 `archive/AGENTS.md` 后再扫描归档目录。
|
|
11
|
-
5. 需要项目规则、经验、领域术语或 ADR 时,读取 `.config/` 下对应文件;`RULES.md` 默认由用户维护,不自动改写。
|
|
12
|
-
|
|
13
|
-
> **配置优先:** 执行任何 workflow、command 或 skill 时,只要涉及项目硬约束、跨任务经验、领域上下文、术语定义、ADR 或决策依据,必须优先参考 `.config/` 下的内容;其中 `RULES.md` 的约束高于普通 workflow 文案。只有在用户明确要求或项目规则允许时,才可写入 `.config/`。
|
|
14
|
-
|
|
15
|
-
## 目录职责
|
|
16
|
-
|
|
17
|
-
| 路径 | 职责 |
|
|
18
|
-
|------|------|
|
|
19
|
-
| `<cat>-status.json` | 当前 active change 的薄索引,可由 `<cat>/<change>/.status.json` 重建 |
|
|
20
|
-
| `<cat>/<change>/` | 当前 change 的 workflow 产物和 `.status.json` |
|
|
21
|
-
| `commands/` | command 产生的报告、快照和一次性操作记录 |
|
|
22
|
-
| `.config/` | 项目规则、经验、context 和 ADR |
|
|
23
|
-
| `archive/` | completed change 的历史归档 |
|
|
24
|
-
|
|
25
|
-
## 写入边界
|
|
26
|
-
|
|
27
|
-
- 新 change 目录必须为 `YYYY-MM-DD-<kebab-name>`。
|
|
28
|
-
- command 产物目录必须为 `YYYY-MM-DD-<cmd-name>-<topic>`。
|
|
29
|
-
- 不要把状态写到项目根目录的裸 `.speculo/`、`temp/` 或系统临时目录。
|
|
30
|
-
- 不要把 archive 当作当前工作目录;需要恢复或迁移历史产物时,先明确说明目标和影响。
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
# Speculo Archive AGENTS Guide
|
|
2
|
-
|
|
3
|
-
本目录保存已完成 change 的历史归档,用于回溯决策、提取经验和支撑 docs-sync。默认只读,不作为当前工作状态。
|
|
4
|
-
|
|
5
|
-
## 目录形态
|
|
6
|
-
|
|
7
|
-
```text
|
|
8
|
-
archive/
|
|
9
|
-
├── dev/<YYYY-MM>/<change-name>/
|
|
10
|
-
├── doc/<YYYY-MM>/<change-name>/
|
|
11
|
-
└── person/<YYYY-MM>/<change-name>/
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
- `<YYYY-MM>` 从 change 名称的日期前缀提取。
|
|
15
|
-
- `<change-name>` 必须保持原始 `YYYY-MM-DD-<kebab-name>`。
|
|
16
|
-
- 归档目录内保留该 change 原本的 `.status.json` 和产物文件。
|
|
17
|
-
|
|
18
|
-
## 读取方式
|
|
19
|
-
|
|
20
|
-
1. 先按分类和月份缩小范围,避免全量读取历史。
|
|
21
|
-
2. 读取目标归档 change 的 `.status.json`,确认 `change_status`、最后 phase 和产物路径。
|
|
22
|
-
3. 只读取与当前问题相关的归档产物;需要提取知识时,把候选写入当前 workflow 产物,由用户确认后再进入 `.config/`。
|
|
23
|
-
|
|
24
|
-
## 操作边界
|
|
25
|
-
|
|
26
|
-
- 不自动重写、删除或移动 archive 内容。
|
|
27
|
-
- 归档移动由 `speculo/commands/archive.md` 或 `speculo/workflows/dev/04-finalize/04-finalize.md` 负责。
|
|
28
|
-
- 若发现归档路径冲突、缺少 `.status.json` 或命名不符合 `YYYY-MM-DD-`,只报告问题,不自行修复。
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schema_version": 2,
|
|
3
|
-
"skill": "docs-sync",
|
|
4
|
-
"state_path": "speculo/.speculo/dev/docs-sync-state.json",
|
|
5
|
-
"tracked_assets": [],
|
|
6
|
-
"last_sync_sha": null,
|
|
7
|
-
"last_sync_short": null,
|
|
8
|
-
"last_sync_commit_subject": null,
|
|
9
|
-
"last_sync_commit_date": null,
|
|
10
|
-
"last_sync_run_at": null,
|
|
11
|
-
"previous_sync_sha": null,
|
|
12
|
-
"total_syncs": 0,
|
|
13
|
-
"synced_assets": []
|
|
14
|
-
}
|
|
File without changes
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"active": []}
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: archive
|
|
3
|
-
type: command
|
|
4
|
-
name: Archive Changes
|
|
5
|
-
description: 归档已完成的 change 到 archive/<cat>/<YYYY-MM>/
|
|
6
|
-
keywords: [archive, 归档, 清理]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Archive 命令
|
|
10
|
-
|
|
11
|
-
⚠️ **本命令是破坏性目录移动操作。AI 必须先列出待归档清单并征求用户确认才能执行。**
|
|
12
|
-
|
|
13
|
-
## 归档路径模式
|
|
14
|
-
|
|
15
|
-
产物目录:`speculo/.speculo/commands/<YYYY-MM-DD>-archive-<topic>/`
|
|
16
|
-
|
|
17
|
-
报告文件:`speculo/.speculo/commands/<YYYY-MM-DD>-archive-<topic>/report.md`
|
|
18
|
-
|
|
19
|
-
- `<YYYY-MM-DD>` 使用当前日期。
|
|
20
|
-
- `<topic>` 从归档范围或用户主题提取,使用小写 kebab-case;无法判断时使用 `changes`。
|
|
21
|
-
- 禁止把命令报告写入 `temp/`、系统临时目录或工作区内其他非规范位置。
|
|
22
|
-
|
|
23
|
-
## 调用的 skills
|
|
24
|
-
|
|
25
|
-
无
|
|
26
|
-
|
|
27
|
-
## 执行步骤
|
|
28
|
-
|
|
29
|
-
1. **预扫描:** 列出 `speculo/.speculo/<cat>/`(内置分类至少包括 `dev`、`doc` 与 `person`)下所有符合 `YYYY-MM-DD-<kebab-name>` 格式的 change 目录。对每个目录检查 `.status.json` 是否存在:
|
|
30
|
-
- 存在且 `change_status: completed` → 加入待归档候选。
|
|
31
|
-
- 存在但 `change_status` 为其他值 → 跳过(非完成状态)。
|
|
32
|
-
- **不存在 `.status.json`** → 标记为 `broken-change: missing .status.json`,**不归档、不删除、不移动**,在清单中单独列出并跳过。
|
|
33
|
-
2. 排除已经位于 `speculo/.speculo/archive/` 下的目录;若目标归档路径已存在,标记为冲突并停止,不覆盖。
|
|
34
|
-
3. 列出完整清单(分三组):
|
|
35
|
-
- **待归档:** 源路径、目标路径、当前分类、`updated_at`、最后 phase、是否仍在 `<cat>-status.json active[]`。
|
|
36
|
-
- **broken-change:** 缺少 `.status.json` 的 change 目录路径。
|
|
37
|
-
- **冲突:** 目标路径已存在的 change。
|
|
38
|
-
4. 向用户展示清单并等待明确确认。没有确认时只输出计划,不移动目录、不改索引。对于 `broken-change`,提示用户需先通过对应 workflow 入口(`dev/AGENTS.md`、`doc/AGENTS.md` 或 `person/AGENTS.md`)补建 `.status.json`,或将 `change_status` 手动置为 `completed` 后再归档。
|
|
39
|
-
5. 用户确认后逐项执行(仅对待归档项):
|
|
40
|
-
- 创建 `speculo/.speculo/archive/<cat>/<YYYY-MM>/`
|
|
41
|
-
- 移动 change 目录到 `speculo/.speculo/archive/<cat>/<YYYY-MM>/<change-name>/`
|
|
42
|
-
- 从对应 `speculo/.speculo/<cat>-status.json` 的 `active[]` 删除该 change
|
|
43
|
-
- 写入本次命令报告 `speculo/.speculo/commands/<YYYY-MM-DD>-archive-<topic>/report.md`
|
|
44
|
-
6. 若任一移动失败,停止后续移动,报告已完成与未完成清单;不要回滚已经成功移动的目录,除非用户明确要求。
|
|
45
|
-
|
|
46
|
-
## 产物模板(report.md)
|
|
47
|
-
|
|
48
|
-
> **服务命令:** `archive.md`
|
|
49
|
-
> **产物文件名:** `report.md`
|
|
50
|
-
|
|
51
|
-
```markdown
|
|
52
|
-
# Archive Report
|
|
53
|
-
|
|
54
|
-
## 执行时间
|
|
55
|
-
[TODO: ISO 时间戳]
|
|
56
|
-
|
|
57
|
-
## 归档清单
|
|
58
|
-
[TODO: 列出本次归档的所有 change,格式 "<source-path> → <dest-path>"]
|
|
59
|
-
|
|
60
|
-
## 跳过清单
|
|
61
|
-
[TODO: 列出被跳过的 broken-change(缺少 .status.json)和冲突项]
|
|
62
|
-
|
|
63
|
-
## 用户确认记录
|
|
64
|
-
[TODO: 记录用户确认的原始内容]
|
|
65
|
-
|
|
66
|
-
## 执行结果
|
|
67
|
-
[TODO: 成功 / 失败 / 部分成功]
|
|
68
|
-
```
|