@namewta/speculo 0.2.2 → 0.2.6
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 +11 -15
- package/dist/src/index.js +72 -8
- package/dist/src/index.js.map +1 -1
- package/dist/src/migrate.js +8 -8
- package/dist/src/migrate.js.map +1 -1
- package/dist/src/workflows.js +2 -2
- package/dist/src/workflows.js.map +1 -1
- package/package.json +1 -1
- package/template/.speculo/README.md +3 -3
- package/template/AGENTS.md +4 -0
- package/template/CLAUDE.md +3 -0
- package/template/canonical/README.md +114 -0
- package/template/canonical/canonical-domain-modeling.md +289 -0
- package/template/canonical/canonical-skill-example.md +608 -0
- package/template/canonical/canonical-teach.md +296 -0
- package/template/commands/archive-and-consolidate.md +49 -0
- package/template/commands/docs-sync.md +2 -2
- package/template/commands/retro.md +9 -7
- package/template/commands/status.md +2 -2
- package/template/skills/archive-and-consolidate/SKILL.md +179 -0
- package/template/skills/archive-and-consolidate/assets/archive-plan-template.md +34 -0
- package/template/skills/archive-and-consolidate/assets/cleanup-candidate-template.md +69 -0
- package/template/skills/archive-and-consolidate/assets/consolidation-plan-template.md +67 -0
- package/template/skills/archive-and-consolidate/references/archive-rules.md +48 -0
- package/template/skills/archive-and-consolidate/references/cleanup-rules.md +73 -0
- package/template/skills/archive-and-consolidate/references/consolidation-rules.md +70 -0
- package/template/skills/archive-and-consolidate/references/knowledge-graduation.md +50 -0
- package/template/skills/docs-sync/SKILL.md +1 -1
- package/template/skills/docs-sync/references/readme-contract.md +2 -0
- package/template/skills/docs-sync/references/readme-writing-guide.md +294 -0
- package/template/skills/docs-sync/references/workflow-scope-contract.md +3 -3
- package/template/skills/speculo-retro/SKILL.md +1 -1
- package/template/skills/speculo-retro/references/issue-drafting-sop.md +1 -1
- package/template/skills/worktree-isolation/references/merge-and-cleanup.md +2 -2
- package/template/vendor/README.md +3 -3
- package/template/vendor/khazix-skills/neat-freak/SKILL.md +210 -0
- package/template/vendor/khazix-skills/neat-freak/references/agent-paths.md +72 -0
- package/template/vendor/khazix-skills/neat-freak/references/governance.md +88 -0
- package/template/vendor/khazix-skills/neat-freak/references/sync-matrix.md +77 -0
- package/template/vendor/khazix-skills/neat-freak/references/verification.md +92 -0
- package/template/vendor/khazix-skills/neat-freak/scripts/audit-inventory.sh +106 -0
- package/template/workflows/person/INDEX.md +12 -0
- package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +73 -74
- package/template/workflows/specdev/D-diagnose-bugs/D-diagnose-bugs.md +85 -0
- package/template/workflows/specdev/D-diagnose-bugs/cleanup-postmortem.md +37 -0
- package/template/workflows/specdev/D-diagnose-bugs/feedback-loop-techniques.md +84 -0
- package/template/workflows/specdev/D-diagnose-bugs/hypothesis-format.md +46 -0
- package/template/workflows/specdev/D-diagnose-bugs/instrumentation-rules.md +51 -0
- package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +54 -0
- package/template/workflows/specdev/G-grill-with-docs/adr-format.md +77 -0
- package/template/workflows/specdev/G-grill-with-docs/context-format.md +63 -0
- package/template/workflows/specdev/G-grill-with-docs/domain-modeling-rules.md +93 -0
- package/template/workflows/specdev/G-grill-with-docs/grilling-protocol.md +54 -0
- package/template/workflows/specdev/G-grill-with-docs/log-format.md +99 -0
- package/template/workflows/specdev/I-implement/I-implement.md +85 -0
- package/template/workflows/specdev/I-implement/code-review-process.md +83 -0
- package/template/workflows/specdev/I-implement/codebase-design-glossary.md +109 -0
- package/template/workflows/specdev/I-implement/deepening.md +37 -0
- package/template/workflows/specdev/I-implement/design-it-twice.md +44 -0
- package/template/workflows/specdev/I-implement/tdd-examples.md +139 -0
- package/template/workflows/specdev/I-implement/tdd-rules.md +31 -0
- package/template/workflows/specdev/I-init-setup/I-init-setup.md +132 -0
- package/template/workflows/specdev/I-init-setup/domain-layout.md +90 -0
- package/template/workflows/specdev/I-init-setup/status-labels.md +54 -0
- package/template/workflows/specdev/I-init-setup/tracking-convention.md +58 -0
- package/template/workflows/specdev/INDEX.md +81 -0
- package/template/workflows/specdev/S-spec/S-spec.md +91 -0
- package/template/workflows/specdev/T-tickets/T-tickets.md +241 -0
- package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +209 -0
- package/template/workflows/specdev/_state/adr/.gitkeep +0 -0
- package/template/workflows/specdev/_state/archive/.gitkeep +0 -0
- package/template/workflows/specdev/_state/changes/.gitkeep +0 -0
- package/template/workflows/specdev/_state/context/.gitkeep +0 -0
- package/template/workflows/{matt-pocock → specdev}/_state/status.json +1 -1
- package/template/commands/finalize.md +0 -37
- package/template/commands/knowledge-prune.md +0 -20
- package/template/skills/change-lifecycle/SKILL.md +0 -25
- package/template/skills/change-lifecycle/assets/completion-summary-template.md +0 -25
- package/template/skills/change-lifecycle/assets/completion-verification-template.md +0 -29
- package/template/skills/change-lifecycle/references/completion-gate.md +0 -19
- package/template/skills/change-lifecycle/references/finalize-archive.md +0 -32
- package/template/skills/knowledge-prune/SKILL.md +0 -29
- package/template/skills/knowledge-prune/references/audit-rules.md +0 -24
- package/template/skills/runtime-context/SKILL.md +0 -54
- package/template/skills/runtime-context/references/path-resolution.md +0 -41
- package/template/workflows/matt-pocock/PERSISTENCE.md +0 -80
- package/template/workflows/matt-pocock/WORKFLOW.md +0 -103
- package/template/workflows/matt-pocock/_state/archive/.gitkeep +0 -1
- package/template/workflows/matt-pocock/_state/changes/.gitkeep +0 -1
- package/template/workflows/matt-pocock/atomic-skills/ask-matt.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/claude-handoff.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/code-review.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/codebase-design.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/diagnosing-bugs.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/domain-modeling.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/grill-me.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/grill-with-docs.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/grilling.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/handoff.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/implement.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/improve-codebase-architecture.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/loop-me.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/prototype.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/research.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/resolving-merge-conflicts.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/setup-matt-pocock-skills.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/tdd.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/teach.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/to-spec.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/to-tickets.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/triage.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/wayfinder.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/wizard.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/writing-beats.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/writing-fragments.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/writing-great-skills.md +0 -21
- package/template/workflows/matt-pocock/atomic-skills/writing-shape.md +0 -20
- package/template/workflows/matt-pocock/routes/architecture.md +0 -24
- package/template/workflows/matt-pocock/routes/diagnose.md +0 -22
- package/template/workflows/matt-pocock/routes/experimental.md +0 -18
- package/template/workflows/matt-pocock/routes/idea-to-delivery.md +0 -63
- package/template/workflows/matt-pocock/routes/merge-conflicts.md +0 -19
- package/template/workflows/matt-pocock/routes/productivity.md +0 -25
- package/template/workflows/matt-pocock/routes/research-prototype.md +0 -20
- package/template/workflows/matt-pocock/routes/review.md +0 -19
- package/template/workflows/matt-pocock/routes/setup.md +0 -42
- package/template/workflows/matt-pocock/routes/triage.md +0 -25
- package/template/workflows/matt-pocock/routes/wayfinder.md +0 -27
- package/template/workflows/person/PERSISTENCE.md +0 -56
- package/template/workflows/person/WORKFLOW.md +0 -50
- package/template/workflows/person/_state/.config/LESSONS.md +0 -3
- package/template/workflows/person/_state/.config/RULES.md +0 -3
- package/template/workflows/person/_state/.config/context/.gitkeep +0 -1
- package/template/workflows/person/_templates/mao-consultation-output-template.md +0 -55
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: improve-codebase-architecture
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Improve Codebase Architecture
|
|
6
|
-
description: 扫描代码仓并呈现架构深化机会。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Improve Codebase Architecture
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已替代 raw 系统临时目录作为报告边界。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/improve-codebase-architecture/SKILL.md" activation="adapted" /><completion>报告与选择结果已返回,实际路径已记录到 skill history。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: loop-me
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Loop Me
|
|
6
|
-
description: 通过有状态访谈形成可实施的工作流规格。
|
|
7
|
-
stability: experimental
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Loop Me
|
|
12
|
-
|
|
13
|
-
本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已作为实验工作区。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/loop-me/SKILL.md" activation="adapted" /><completion>工作流规格路径已记录到 skill history。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: prototype
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Prototype
|
|
6
|
-
description: 用一次性逻辑或 UI 原型回答单个设计问题。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: model-allowed
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Prototype
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、项目原型与清理边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/prototype/SKILL.md" activation="adapted" /><completion>原型结论已保留,临时代码已删除或吸收,路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: research
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Research
|
|
6
|
-
description: 以一手来源调查问题并形成带引用结论。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: model-allowed
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Research
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与后台研究确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/research/SKILL.md" activation="adapted" /><completion>研究结论与来源已返回,实际文件路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: resolving-merge-conflicts
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Resolving Merge Conflicts
|
|
6
|
-
description: 查明双方意图并解决进行中的 merge 或 rebase 冲突。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: model-allowed
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Resolving Merge Conflicts
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与继续 merge/rebase 的确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/resolving-merge-conflicts/SKILL.md" activation="adapted" /><completion>冲突结果与验证证据已记录;继续或提交仅在确认后执行。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: setup-matt-pocock-skills
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Setup Matt Pocock Skills
|
|
6
|
-
description: 配置 tracker、triage 标签和领域知识布局。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Setup Matt Pocock Skills
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、integrations 与 knowledge namespaces 已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/SKILL.md" activation="adapted" /><completion>确认后的配置写入声明 namespace,实际路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: tdd
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: TDD
|
|
6
|
-
description: 以红绿重构循环构建一个垂直切片。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: model-allowed
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# TDD
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、项目测试与记录边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/tdd/SKILL.md" activation="adapted" /><completion>红绿重构证据已返回,实际记录路径已写入 skill history。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: teach
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Teach
|
|
6
|
-
description: 在持久化教学工作区中跨会话教授主题。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Teach
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 已替代 raw 当前目录作为教学工作区。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/teach/SKILL.md" activation="adapted" /><completion>教学状态与课程产物路径已记录到 skill history。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: to-spec
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: To Spec
|
|
6
|
-
description: 将既有讨论综合为可交付 spec。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# To Spec
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外发确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/to-spec/SKILL.md" activation="adapted" /><completion>spec 先在 change 中形成;外发结果与路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: to-tickets
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: To Tickets
|
|
6
|
-
description: 将计划或 spec 拆分为带阻塞边的 tickets。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# To Tickets
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外发确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/to-tickets/SKILL.md" activation="adapted" /><completion>tickets 先在 change 中形成;外发结果与路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: triage
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Triage
|
|
6
|
-
description: 将 issues 或外部 PR 移过 triage 状态机。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Triage
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、policy 与外部动作确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/triage/SKILL.md" activation="adapted" /><completion>建议先本地记录;确认后的外部结果与路径已写回。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: wayfinder
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Wayfinder
|
|
6
|
-
description: 为大型模糊目标建立并遍历调查地图。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Wayfinder
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与 tracker 外部动作边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="engineering/wayfinder/SKILL.md" activation="adapted" /><completion>地图与前沿先本地记录;确认后的 tracker 结果已写回。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: wizard
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Wizard
|
|
6
|
-
description: 生成用于人工设置或迁移的交互式 bash 向导。
|
|
7
|
-
stability: experimental
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Wizard
|
|
12
|
-
|
|
13
|
-
本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change、secret 与外部动作确认边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/wizard/SKILL.md" activation="adapted" /><completion>脚本已静态验证;临时/项目归属与外部写入结果已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: writing-beats
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Writing Beats
|
|
6
|
-
description: 从素材堆逐节拍组装文章旅程。
|
|
7
|
-
stability: experimental
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Writing Beats
|
|
12
|
-
|
|
13
|
-
本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-beats/SKILL.md" activation="adapted" /><completion>文章与素材路径已记录,用户编辑得到保留。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: writing-fragments
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Writing Fragments
|
|
6
|
-
description: 通过访谈探索并追加写作碎片。
|
|
7
|
-
stability: experimental
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Writing Fragments
|
|
12
|
-
|
|
13
|
-
本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-fragments/SKILL.md" activation="adapted" /><completion>碎片文档路径已记录,用户编辑得到保留。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: writing-great-skills
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Writing Great Skills
|
|
6
|
-
description: 使用可预测性模型设计或审查 skill。
|
|
7
|
-
stability: stable
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Writing Great Skills
|
|
12
|
-
|
|
13
|
-
直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 与项目 skill 产物边界已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="productivity/writing-great-skills/SKILL.md" activation="adapted" /><completion>skill 审计结论与实际修改/报告路径已记录。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
21
|
-
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: writing-shape
|
|
3
|
-
type: atomic-skill
|
|
4
|
-
workflow: matt-pocock
|
|
5
|
-
name: Writing Shape
|
|
6
|
-
description: 将素材堆逐段塑造成独立文章。
|
|
7
|
-
stability: experimental
|
|
8
|
-
invocation: user-only
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Writing Shape
|
|
12
|
-
|
|
13
|
-
本能力不稳定,仅在用户明确要求时启用。直接调用前必须读取 [PERSISTENCE.md](../PERSISTENCE.md)。
|
|
14
|
-
|
|
15
|
-
```xml
|
|
16
|
-
<sequence>
|
|
17
|
-
<phase id="load-persistence" order="1"><instructions root="workflow" path="PERSISTENCE.md" activation="required" /><completion>current change 或用户明确项目目标已解析。</completion></phase>
|
|
18
|
-
<phase id="invoke" order="2"><skill root="vendor:matt-pocock" path="in-progress/writing-shape/SKILL.md" activation="adapted" /><completion>文章路径已记录,素材与用户编辑得到保留。</completion></phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# Architecture
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="scan" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/improve-codebase-architecture.md" activation="adapted" />
|
|
9
|
-
<instructions root="workflow" path="atomic-skills/codebase-design.md" activation="required" />
|
|
10
|
-
<artifact root="change" path="architecture/candidates.html" />
|
|
11
|
-
<completion>报告写入当前 change 而非系统临时目录,候选使用统一设计词汇。</completion>
|
|
12
|
-
</phase>
|
|
13
|
-
<phase id="select-grill" order="2">
|
|
14
|
-
<instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
|
|
15
|
-
<instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
|
|
16
|
-
<artifact root="change" path="architecture/design.md" />
|
|
17
|
-
<completion>用户选择的候选已遍历设计树,拒绝理由和 ADR 候选已确认。</completion>
|
|
18
|
-
</phase>
|
|
19
|
-
<phase id="deliver" order="3">
|
|
20
|
-
<instructions root="workflow" path="routes/idea-to-delivery.md" />
|
|
21
|
-
<completion>选中设计已进入 spec 或 implement。</completion>
|
|
22
|
-
</phase>
|
|
23
|
-
</sequence>
|
|
24
|
-
```
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
# Diagnose
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="feedback-loop" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/diagnosing-bugs.md" activation="required" />
|
|
9
|
-
<artifact root="change" path="diagnosis/feedback-loop.md" />
|
|
10
|
-
<completion>存在一条已运行、能对当前症状变红、快速且确定的命令;否则 blocked。</completion>
|
|
11
|
-
</phase>
|
|
12
|
-
<phase id="diagnose-fix" order="2">
|
|
13
|
-
<artifact root="change" path="diagnosis/report.md" />
|
|
14
|
-
<completion>复现已最小化,假设已验证,修复前已有正确缝合点的回归测试。</completion>
|
|
15
|
-
</phase>
|
|
16
|
-
<phase id="architecture-followup" order="3">
|
|
17
|
-
<when>缺少正确测试缝合点或暴露架构摩擦。</when>
|
|
18
|
-
<instructions root="workflow" path="routes/architecture.md" />
|
|
19
|
-
<completion>架构发现已记录,不阻塞 bug 修复完成。</completion>
|
|
20
|
-
</phase>
|
|
21
|
-
</sequence>
|
|
22
|
-
```
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
# Experimental
|
|
2
|
-
|
|
3
|
-
本 route 不参与默认选择。进入前明确告知能力位于 vendor/in-progress,可能发生破坏性变化。
|
|
4
|
-
|
|
5
|
-
## 路由
|
|
6
|
-
|
|
7
|
-
```xml
|
|
8
|
-
<routes>
|
|
9
|
-
<route id="loop-me" order="1" root="workflow" path="atomic-skills/loop-me.md" />
|
|
10
|
-
<route id="wizard" order="2" root="workflow" path="atomic-skills/wizard.md" />
|
|
11
|
-
<route id="claude-handoff" order="3" root="workflow" path="atomic-skills/claude-handoff.md" />
|
|
12
|
-
<route id="writing-fragments" order="4" root="workflow" path="atomic-skills/writing-fragments.md" />
|
|
13
|
-
<route id="writing-beats" order="5" root="workflow" path="atomic-skills/writing-beats.md" />
|
|
14
|
-
<route id="writing-shape" order="6" root="workflow" path="atomic-skills/writing-shape.md" />
|
|
15
|
-
</routes>
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
所有文件输出改写到当前 change 的 `experimental/<route>/`。启动后台 agent、写 secrets、创建脚本、提交文件或操作外部系统前必须单独确认并记录 receipt。
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
# Idea To Delivery
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="grill" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/grill-with-docs.md" activation="conditional">
|
|
9
|
-
<when>当前任务位于已有代码仓,需要同步领域语言与 ADR 候选。</when>
|
|
10
|
-
</instructions>
|
|
11
|
-
<instructions root="workflow" path="atomic-skills/grill-me.md" activation="conditional">
|
|
12
|
-
<when>用户显式要求 grill-me,或计划/设计不依赖现有代码仓。</when>
|
|
13
|
-
</instructions>
|
|
14
|
-
<instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
|
|
15
|
-
<instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional">
|
|
16
|
-
<when>存在代码仓并需要沉淀领域语言或 ADR 候选。</when>
|
|
17
|
-
</instructions>
|
|
18
|
-
<artifact root="change" path="decision-log.md" />
|
|
19
|
-
<completion>一次只确认一个决策;所有关键分支均已清晰且用户确认达成共识后,才允许形成 Plan 或进入 spec。CONTEXT/ADR 仅在确认后写入 knowledge namespace。</completion>
|
|
20
|
-
</phase>
|
|
21
|
-
<phase id="detour" order="2">
|
|
22
|
-
<when>问题需要一手资料或可运行/UI 答案。</when>
|
|
23
|
-
<instructions root="workflow" path="routes/research-prototype.md" />
|
|
24
|
-
<completion>答案与来源已回填 decision-log,临时代码已删除。</completion>
|
|
25
|
-
</phase>
|
|
26
|
-
<phase id="spec" order="3">
|
|
27
|
-
<instructions root="workflow" path="atomic-skills/to-spec.md" activation="adapted" />
|
|
28
|
-
<artifact root="change" path="spec/spec.md" />
|
|
29
|
-
<completion>spec 先本地落盘;外发 tracker 需要单独确认。</completion>
|
|
30
|
-
</phase>
|
|
31
|
-
<phase id="tickets" order="4">
|
|
32
|
-
<when>工作跨多个上下文窗口。</when>
|
|
33
|
-
<instructions root="workflow" path="atomic-skills/to-tickets.md" activation="adapted" />
|
|
34
|
-
<artifact root="change" path="tracker/tickets.md" />
|
|
35
|
-
<completion>垂直切片与阻塞边已获用户批准,外发引用已回写。</completion>
|
|
36
|
-
</phase>
|
|
37
|
-
<phase id="implement" order="5">
|
|
38
|
-
<instructions root="workflow" path="atomic-skills/implement.md" activation="adapted" />
|
|
39
|
-
<instructions root="workflow" path="atomic-skills/tdd.md" activation="required" />
|
|
40
|
-
<artifact root="change" path="implementation/log.md" />
|
|
41
|
-
<completion>每个切片已验证;commit 仅在用户确认后执行。</completion>
|
|
42
|
-
</phase>
|
|
43
|
-
<phase id="review" order="6">
|
|
44
|
-
<instructions root="workflow" path="routes/review.md" />
|
|
45
|
-
<completion>标准轴与规范轴均已有报告。</completion>
|
|
46
|
-
</phase>
|
|
47
|
-
<phase id="finalize" order="7">
|
|
48
|
-
<command root="commands" path="finalize.md" />
|
|
49
|
-
<completion>全局完成门禁通过并归档,或明确 blocked。</completion>
|
|
50
|
-
</phase>
|
|
51
|
-
</sequence>
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## 状态转移
|
|
55
|
-
|
|
56
|
-
```xml
|
|
57
|
-
<transitions>
|
|
58
|
-
<transition from="grill" to="spec"><when>决策完整且无需继续 detour。</when></transition>
|
|
59
|
-
<transition from="spec" to="tickets"><when>实现跨上下文。</when></transition>
|
|
60
|
-
<transition from="spec" to="implement"><when>单上下文可完成。</when></transition>
|
|
61
|
-
<transition from="review" to="implement"><when>审查发现必须修复的问题。</when></transition>
|
|
62
|
-
</transitions>
|
|
63
|
-
```
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# Merge Conflicts
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="inspect-intent" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/resolving-merge-conflicts.md" activation="required" />
|
|
9
|
-
<artifact root="change" path="merge-conflicts/record.md" />
|
|
10
|
-
<completion>每个冲突双方的一手意图已查明。</completion>
|
|
11
|
-
</phase>
|
|
12
|
-
<phase id="resolve-verify" order="2">
|
|
13
|
-
<completion>冲突全部解决、自动化检查通过;没有发明新行为或执行 abort。</completion>
|
|
14
|
-
</phase>
|
|
15
|
-
<phase id="continue" order="3">
|
|
16
|
-
<completion>继续 merge/rebase 与 commit 前已展示动作并获得确认。</completion>
|
|
17
|
-
</phase>
|
|
18
|
-
</sequence>
|
|
19
|
-
```
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Productivity
|
|
2
|
-
|
|
3
|
-
## 路由
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<routes>
|
|
7
|
-
<route id="handoff" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/handoff.md" activation="adapted" />
|
|
9
|
-
<artifact root="change" path="handoffs/{topic}.md" />
|
|
10
|
-
<when>需要跨会话或分叉上下文。</when>
|
|
11
|
-
</route>
|
|
12
|
-
<route id="teach" order="2">
|
|
13
|
-
<instructions root="workflow" path="atomic-skills/teach.md" activation="adapted" />
|
|
14
|
-
<artifact root="change" path="teaching/" />
|
|
15
|
-
<when>用户要跨会话学习主题。</when>
|
|
16
|
-
</route>
|
|
17
|
-
<route id="writing-great-skills" order="3">
|
|
18
|
-
<instructions root="workflow" path="atomic-skills/writing-great-skills.md" activation="required" />
|
|
19
|
-
<artifact root="change" path="skill-authoring/report.md" />
|
|
20
|
-
<when>用户要设计或审查 skill。</when>
|
|
21
|
-
</route>
|
|
22
|
-
</routes>
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
原 handoff 的系统临时目录与 teach 的当前目录均替换为上述 change 内路径。
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
# Research And Prototype
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="research" order="1">
|
|
8
|
-
<when>答案需要当前仓库之外的一手来源。</when>
|
|
9
|
-
<instructions root="workflow" path="atomic-skills/research.md" activation="conditional" />
|
|
10
|
-
<artifact root="change" path="research/{topic}.md" />
|
|
11
|
-
<completion>每项结论有一手来源,文件留在当前 change。</completion>
|
|
12
|
-
</phase>
|
|
13
|
-
<phase id="prototype" order="2">
|
|
14
|
-
<when>状态、逻辑或 UI 需要可运行答案。</when>
|
|
15
|
-
<instructions root="workflow" path="atomic-skills/prototype.md" activation="conditional" />
|
|
16
|
-
<artifact root="change" path="prototypes/{topic}/answer.md" />
|
|
17
|
-
<completion>答案已保留;一次性代码、数据库和路由已删除或明确吸收进实现。</completion>
|
|
18
|
-
</phase>
|
|
19
|
-
</sequence>
|
|
20
|
-
```
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# Review
|
|
2
|
-
|
|
3
|
-
## 阶段
|
|
4
|
-
|
|
5
|
-
```xml
|
|
6
|
-
<sequence>
|
|
7
|
-
<phase id="fixed-point" order="1">
|
|
8
|
-
<instructions root="workflow" path="atomic-skills/code-review.md" activation="required" />
|
|
9
|
-
<completion>固定点可解析、diff 非空、规范与标准来源已记录。</completion>
|
|
10
|
-
</phase>
|
|
11
|
-
<phase id="parallel-axes" order="2">
|
|
12
|
-
<artifact root="change" path="review/report.md" />
|
|
13
|
-
<completion>标准轴与规范轴相互隔离执行,并排呈现且不重新排名。</completion>
|
|
14
|
-
</phase>
|
|
15
|
-
<phase id="decision" order="3">
|
|
16
|
-
<completion>发现数量、各轴最严重问题和下一步已记录;未经要求不实施修复。</completion>
|
|
17
|
-
</phase>
|
|
18
|
-
</sequence>
|
|
19
|
-
```
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# Route Setup
|
|
2
|
-
|
|
3
|
-
仅在目标 route 缺少配置时读取原 setup skill;保持其探索和逐项确认方法,但使用 Matt 已声明的 state namespace。
|
|
4
|
-
|
|
5
|
-
## 阶段
|
|
6
|
-
|
|
7
|
-
```xml
|
|
8
|
-
<sequence>
|
|
9
|
-
<phase id="discover-config" order="1">
|
|
10
|
-
<instructions root="workflow" path="atomic-skills/setup-matt-pocock-skills.md" activation="adapted" />
|
|
11
|
-
<completion>已展示仓库、tracker 和领域文档现状。</completion>
|
|
12
|
-
</phase>
|
|
13
|
-
<phase id="configure-tracker" order="2">
|
|
14
|
-
<when>route 需要 issue tracker。</when>
|
|
15
|
-
<template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/issue-tracker-local.md" />
|
|
16
|
-
<artifact root="state" path="integrations/issue-tracker.md" />
|
|
17
|
-
<completion>用户已确认 GitHub、GitLab、本地或其他 tracker;本地 tracker 根为当前 change/tracker。</completion>
|
|
18
|
-
</phase>
|
|
19
|
-
<phase id="configure-triage" order="3">
|
|
20
|
-
<when>route 为 triage 或 wayfinder。</when>
|
|
21
|
-
<template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/triage-labels.md" />
|
|
22
|
-
<artifact root="state" path="integrations/triage-labels.md" />
|
|
23
|
-
<completion>五个角色已映射到真实标签。</completion>
|
|
24
|
-
</phase>
|
|
25
|
-
<phase id="configure-domain" order="4">
|
|
26
|
-
<when>route 会读取或维护领域语言。</when>
|
|
27
|
-
<template root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/domain.md" />
|
|
28
|
-
<artifact root="state" path="knowledge/domain.md" />
|
|
29
|
-
<completion>domain.md 指向本 workflow 的 knowledge/context/ 与 knowledge/adr/,未修改项目根 AGENTS/CLAUDE/docs。</completion>
|
|
30
|
-
</phase>
|
|
31
|
-
</sequence>
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
## 状态转移
|
|
35
|
-
|
|
36
|
-
```xml
|
|
37
|
-
<transitions>
|
|
38
|
-
<transition from="missing-config" to="configured">
|
|
39
|
-
<when>目标 route 的必要配置均已由用户确认并写入声明 namespace。</when>
|
|
40
|
-
</transition>
|
|
41
|
-
</transitions>
|
|
42
|
-
```
|