@colin4k1024/tsp 2.4.4 → 2.4.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 +16 -20
- package/bin/lib/install-surface.js +3 -3
- package/bin/lib/source-installer.js +2 -2
- package/commands/team-help.md +2 -2
- package/commands/team-plan.md +1 -1
- package/commands/update-codemaps.md +3 -3
- package/manifests/install-components.json +1 -1
- package/manifests/install-modules.json +17 -3
- package/manifests/install-profiles.json +2 -0
- package/package.json +6 -3
- package/schemas/ecc-install-config.schema.json +6 -1
- package/schemas/install-modules.schema.json +4 -1
- package/scripts/codegraph-preflight.js +179 -0
- package/scripts/gitnexus-preflight.js +8 -0
- package/scripts/install-apply.js +10 -8
- package/scripts/install-codegraph.js +158 -0
- package/scripts/install-plan.js +28 -11
- package/scripts/lib/install/apply.js +256 -5
- package/scripts/lib/install/request.js +3 -2
- package/scripts/lib/install-audit-manifest.js +3 -0
- package/scripts/lib/install-executor.js +14 -5
- package/scripts/lib/install-lifecycle.js +2 -2
- package/scripts/lib/install-manifests.js +23 -4
- package/scripts/lib/install-targets/codex-home.js +187 -1
- package/scripts/lib/install-targets/opencode-home.js +135 -2
- package/scripts/lib/install-targets/registry.js +23 -1
- package/scripts/lib/release-health.js +19 -4
- package/scripts/lib/team-skills-data.json +6 -6
- package/scripts/release-health-summary.js +1 -1
- package/scripts/workflow-help.js +3 -3
- package/skills/codegraph/SKILL.md +57 -0
- package/skills/codegraph/agents/openai.yaml +4 -0
- package/docs/.vitepress/config.mts +0 -199
- package/docs/adr/ADR-001-doc-architecture-integration.md +0 -33
- package/docs/guides/README.md +0 -5
- package/docs/guides/installation.md +0 -33
- package/docs/guides/user-guide.md +0 -36
- package/docs/index.md +0 -65
- package/docs/memory/backlog.md +0 -10
- package/docs/memory/decisions.md +0 -43
- package/docs/memory/lessons-learned.md +0 -87
- package/docs/plans/2026-04-03-python-remnants-audit.md +0 -265
- package/docs/plans/2026-04-03-scripts-python-to-js-migration.md +0 -372
- package/docs/plans/2026-04-03-solo-delivery-execution-checklist.md +0 -413
- package/docs/plans/2026-04-03-solo-delivery-gap-plan.md +0 -377
- package/docs/plans/2026-04-03-team-skills-workflow-gates.md +0 -548
- package/docs/plans/2026-04-21-open-source-readiness-gap-plan.md +0 -217
- package/docs/plans/llm-surface-reduction-audit.md +0 -147
- package/docs/plans/llm-surface-reduction-execution-checklist.md +0 -217
- package/docs/plans/llm-surface-reduction-execution-history.md +0 -124
- package/docs/plans/team-skills-platform-migration.md +0 -54
- package/docs/presentation/README.md +0 -42
- package/docs/presentation/audience-presentation-route-map.md +0 -84
- package/docs/presentation/executive-briefing-talk-track.md +0 -50
- package/docs/presentation/generate_capability_matrix.py +0 -396
- package/docs/presentation/generate_ppt.py +0 -354
- package/docs/presentation/implementation-onboarding-brief.md +0 -38
- package/docs/presentation/presentation-talk-track.md +0 -97
- package/docs/presentation/vertical-scenario-route-map.md +0 -99
- package/docs/presentation/workshop-facilitator-guide.md +0 -47
- package/docs/runbooks/actionlint-workflow-gates.md +0 -80
- package/docs/runbooks/agent-governance.md +0 -131
- package/docs/runbooks/ai-eval-platform-demo-execution-log.md +0 -147
- package/docs/runbooks/ai-eval-platform-demo-script.md +0 -136
- package/docs/runbooks/ai-eval-platform-walkthrough.md +0 -113
- package/docs/runbooks/ai-pr-review-automation.md +0 -56
- package/docs/runbooks/api-breaking-change-gates.md +0 -58
- package/docs/runbooks/api-design-evolution-walkthrough.md +0 -42
- package/docs/runbooks/api-lint-gates.md +0 -57
- package/docs/runbooks/api-mocking-strategy-and-lifecycle-guide.md +0 -47
- package/docs/runbooks/architect-daily-operations.md +0 -63
- package/docs/runbooks/architect-design-conversation-example.md +0 -83
- package/docs/runbooks/artifact-attestation-gates.md +0 -75
- package/docs/runbooks/artifact-persistence.md +0 -257
- package/docs/runbooks/backend-engineer-daily-operations.md +0 -63
- package/docs/runbooks/batch-optimization-completion-checklist.md +0 -104
- package/docs/runbooks/biz-service-designer-end-to-end-conversation-example.md +0 -5
- package/docs/runbooks/biz-service-designer-toolkit.md +0 -5
- package/docs/runbooks/bug-fix-complete-walkthrough.md +0 -60
- package/docs/runbooks/build-failure-recovery-walkthrough.md +0 -40
- package/docs/runbooks/canary-decision-matrix.md +0 -41
- package/docs/runbooks/canary-staging-release-walkthrough.md +0 -46
- package/docs/runbooks/checkov-iac-gates.md +0 -104
- package/docs/runbooks/claude-code-review-workflow.md +0 -72
- package/docs/runbooks/claude-conversation-prompt-recipes.md +0 -132
- package/docs/runbooks/claude-end-to-end-conversation-example.md +0 -198
- package/docs/runbooks/claude-feature-development-guide.md +0 -112
- package/docs/runbooks/claude-quick-start.md +0 -227
- package/docs/runbooks/claude-usage-scenarios.md +0 -176
- package/docs/runbooks/code-review-collaboration-walkthrough.md +0 -65
- package/docs/runbooks/codeql-pr-security-gates.md +0 -64
- package/docs/runbooks/codex-end-to-end-conversation-example.md +0 -166
- package/docs/runbooks/codex-multi-agent-orchestration.md +0 -65
- package/docs/runbooks/codex-parallel-prompt-recipes.md +0 -131
- package/docs/runbooks/codex-quick-start.md +0 -223
- package/docs/runbooks/codex-usage-scenarios.md +0 -168
- package/docs/runbooks/codex-workflow-essentials.md +0 -88
- package/docs/runbooks/command-and-capability-matrix.md +0 -162
- package/docs/runbooks/conftest-policy-gates.md +0 -84
- package/docs/runbooks/consumer-driven-contract-testing-with-mock-alignment.md +0 -45
- package/docs/runbooks/contract-testing-playbook.md +0 -78
- package/docs/runbooks/cosign-signing-gates.md +0 -71
- package/docs/runbooks/cross-role-issue-triage-walkthrough.md +0 -47
- package/docs/runbooks/cursor-quick-start.md +0 -123
- package/docs/runbooks/custom-overlay.md +0 -115
- package/docs/runbooks/data-ml-pipeline-demo-execution-log.md +0 -141
- package/docs/runbooks/data-ml-pipeline-demo-script.md +0 -102
- package/docs/runbooks/data-ml-pipeline-walkthrough.md +0 -119
- package/docs/runbooks/data-observability-quality-demo-execution-log.md +0 -36
- package/docs/runbooks/data-observability-quality-demo-script.md +0 -42
- package/docs/runbooks/data-observability-quality-walkthrough.md +0 -86
- package/docs/runbooks/demo-deliverables-overview.md +0 -278
- package/docs/runbooks/demo-execution-log.md +0 -530
- package/docs/runbooks/demo-scenario.md +0 -129
- package/docs/runbooks/dependency-review-gates.md +0 -63
- package/docs/runbooks/dependency-update-automation.md +0 -83
- package/docs/runbooks/design-md-workflow.md +0 -185
- package/docs/runbooks/devops-engineer-daily-operations.md +0 -60
- package/docs/runbooks/devops-release-conversation-example.md +0 -88
- package/docs/runbooks/doc-architecture-integration.md +0 -59
- package/docs/runbooks/doc-architecture-quick-start.md +0 -122
- package/docs/runbooks/document-execution-audit.md +0 -32
- package/docs/runbooks/documentation-update-walkthrough.md +0 -37
- package/docs/runbooks/ecc-harness-usage.md +0 -93
- package/docs/runbooks/error-experience-usage.md +0 -116
- package/docs/runbooks/evolution-usage.md +0 -162
- package/docs/runbooks/executive-value-one-page.md +0 -55
- package/docs/runbooks/external-capability-approval-and-enablement-workflow.md +0 -39
- package/docs/runbooks/external-capability-intake.md +0 -160
- package/docs/runbooks/first-team-command-60-seconds.md +0 -96
- package/docs/runbooks/first-team-workflow-walkthrough.md +0 -245
- package/docs/runbooks/frontend-backend-integration-acceptance-checklist.md +0 -46
- package/docs/runbooks/frontend-backend-parallel-integration-walkthrough.md +0 -48
- package/docs/runbooks/frontend-bugfix-one-page.md +0 -82
- package/docs/runbooks/frontend-engineer-daily-operations.md +0 -60
- package/docs/runbooks/frontend-enterprise-style-profile.md +0 -5
- package/docs/runbooks/frontend-governance.md +0 -47
- package/docs/runbooks/frontend-refactor-walkthrough.md +0 -42
- package/docs/runbooks/git-pr-workflow.md +0 -63
- package/docs/runbooks/github-actions-supply-chain-demo-execution-log.md +0 -158
- package/docs/runbooks/github-actions-supply-chain-demo-script.md +0 -150
- package/docs/runbooks/github-actions-supply-chain-walkthrough.md +0 -117
- package/docs/runbooks/github-token-permissions-baseline.md +0 -92
- package/docs/runbooks/gitlab-manual-pipeline-release.md +0 -5
- package/docs/runbooks/gitlab-release-integration-playbook.md +0 -5
- package/docs/runbooks/gitnexus-code-intelligence-usage.md +0 -133
- package/docs/runbooks/graphify-knowledge-graph-usage.md +0 -88
- package/docs/runbooks/handoff-filling-guide-with-examples.md +0 -70
- package/docs/runbooks/handoff-governance.md +0 -250
- package/docs/runbooks/helm-unittest-playbook.md +0 -101
- package/docs/runbooks/hotfix-emergency-release-walkthrough.md +0 -60
- package/docs/runbooks/iac-kubernetes-platform-demo-execution-log.md +0 -144
- package/docs/runbooks/iac-kubernetes-platform-demo-script.md +0 -130
- package/docs/runbooks/iac-kubernetes-platform-walkthrough.md +0 -120
- package/docs/runbooks/implementation-onboarding-reading-path.md +0 -67
- package/docs/runbooks/in-toto-attestation-framework.md +0 -94
- package/docs/runbooks/incident-severity-triage-tree.md +0 -43
- package/docs/runbooks/incident-triage-one-page.md +0 -65
- package/docs/runbooks/internal-developer-platform-demo-execution-log.md +0 -36
- package/docs/runbooks/internal-developer-platform-demo-script.md +0 -42
- package/docs/runbooks/internal-developer-platform-walkthrough.md +0 -91
- package/docs/runbooks/karpathy-guidelines-usage.md +0 -27
- package/docs/runbooks/kubeconform-schema-gates.md +0 -100
- package/docs/runbooks/kubectl-server-dry-run-gates.md +0 -103
- package/docs/runbooks/kyverno-policy-gates.md +0 -90
- package/docs/runbooks/langfuse-and-observability-integration-guide.md +0 -43
- package/docs/runbooks/langfuse-coding-trace.md +0 -44
- package/docs/runbooks/mobile-miniapp-delivery-walkthrough.md +0 -112
- package/docs/runbooks/mobile-miniapp-demo-execution-log.md +0 -139
- package/docs/runbooks/mobile-miniapp-demo-script.md +0 -129
- package/docs/runbooks/multi-service-backend-integration-walkthrough.md +0 -61
- package/docs/runbooks/open-design-integration.md +0 -163
- package/docs/runbooks/open-source-release-checklist.md +0 -90
- package/docs/runbooks/opencode-quick-start.md +0 -128
- package/docs/runbooks/parallel-development-coordination-walkthrough.md +0 -47
- package/docs/runbooks/parallel-execution-usage.md +0 -179
- package/docs/runbooks/platform-capability-demo-execution-log.md +0 -184
- package/docs/runbooks/platform-capability-demo-script.md +0 -192
- package/docs/runbooks/plugin-extension-platform-demo-execution-log.md +0 -136
- package/docs/runbooks/plugin-extension-platform-demo-script.md +0 -102
- package/docs/runbooks/plugin-extension-platform-walkthrough.md +0 -111
- package/docs/runbooks/policy-controller-gates.md +0 -75
- package/docs/runbooks/post-rollback-verification-checklist.md +0 -37
- package/docs/runbooks/pre-release-checklist.md +0 -50
- package/docs/runbooks/product-manager-clarification-conversation-example.md +0 -90
- package/docs/runbooks/product-manager-daily-operations.md +0 -60
- package/docs/runbooks/production-incident-response-walkthrough.md +0 -50
- package/docs/runbooks/project-claude-design-rationale.md +0 -188
- package/docs/runbooks/project-manager-daily-operations.md +0 -61
- package/docs/runbooks/project-manager-planning-conversation-example.md +0 -82
- package/docs/runbooks/project-onboarding.md +0 -452
- package/docs/runbooks/qa-engineer-daily-operations.md +0 -63
- package/docs/runbooks/qa-review-conversation-example.md +0 -87
- package/docs/runbooks/release-closure-one-page.md +0 -65
- package/docs/runbooks/release-governance-reading-path.md +0 -56
- package/docs/runbooks/release-notes-automation.md +0 -48
- package/docs/runbooks/release-rollback-recovery-walkthrough.md +0 -47
- package/docs/runbooks/requirement-clarity-and-scope-walkthrough.md +0 -46
- package/docs/runbooks/reviewdog-pr-gates.md +0 -49
- package/docs/runbooks/role-prompt-recipes.md +0 -130
- package/docs/runbooks/rtk-integration-intake.md +0 -45
- package/docs/runbooks/rtk-token-optimization-usage.md +0 -107
- package/docs/runbooks/runner-egress-hardening.md +0 -81
- package/docs/runbooks/runtime-capabilities-overview.md +0 -113
- package/docs/runbooks/sbom-generation-gates.md +0 -71
- package/docs/runbooks/scorecard-supply-chain-gates.md +0 -82
- package/docs/runbooks/secret-scanning-gates.md +0 -85
- package/docs/runbooks/security-compliance-platform-demo-execution-log.md +0 -36
- package/docs/runbooks/security-compliance-platform-demo-script.md +0 -49
- package/docs/runbooks/security-compliance-platform-walkthrough.md +0 -98
- package/docs/runbooks/slsa-generator-patterns.md +0 -73
- package/docs/runbooks/slsa-verification-gates.md +0 -75
- package/docs/runbooks/solo-delivery-mode.md +0 -142
- package/docs/runbooks/solo-delivery-one-page.md +0 -111
- package/docs/runbooks/specialist-commands-playbook.md +0 -85
- package/docs/runbooks/sub-agent-invocation-map.md +0 -144
- package/docs/runbooks/system-architecture-design-walkthrough.md +0 -49
- package/docs/runbooks/team-closeout-example.md +0 -73
- package/docs/runbooks/team-command-output-contracts.md +0 -358
- package/docs/runbooks/team-commands-quick-prompts.md +0 -125
- package/docs/runbooks/team-execute-example.md +0 -63
- package/docs/runbooks/team-handoff-example.md +0 -49
- package/docs/runbooks/team-intake-example.md +0 -70
- package/docs/runbooks/team-plan-example.md +0 -62
- package/docs/runbooks/team-release-example.md +0 -63
- package/docs/runbooks/team-review-example.md +0 -61
- package/docs/runbooks/team-skills-test-run.md +0 -184
- package/docs/runbooks/team-skills-usage.md +0 -336
- package/docs/runbooks/team-training-reading-path.md +0 -64
- package/docs/runbooks/tech-lead-closure-conversation-example.md +0 -78
- package/docs/runbooks/tech-lead-daily-operations.md +0 -67
- package/docs/runbooks/trivy-security-gates.md +0 -79
- package/docs/runbooks/troubleshooting.md +0 -234
- package/docs/runbooks/vertical-scenario-capability-matrix.md +0 -107
- package/docs/runbooks/witness-policy-gates.md +0 -78
- package/docs/runbooks/zizmor-workflow-audits.md +0 -81
|
@@ -1,179 +0,0 @@
|
|
|
1
|
-
# Parallel Execution Framework 使用指南
|
|
2
|
-
|
|
3
|
-
## 概述
|
|
4
|
-
|
|
5
|
-
Parallel Execution Framework(并行执行框架)提供:
|
|
6
|
-
- 任务智能拆分
|
|
7
|
-
- Git worktree 多分支并行
|
|
8
|
-
- 动态实例扩展
|
|
9
|
-
- 结果自动汇总
|
|
10
|
-
|
|
11
|
-
## 架构
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
15
|
-
│ Parallel Execution │
|
|
16
|
-
├─────────────────────────────────────────────────────────────┤
|
|
17
|
-
│ Task Input → Decomposer → Task Queue │
|
|
18
|
-
│ ↓ │
|
|
19
|
-
│ ┌────────────────┼────────────────┐ │
|
|
20
|
-
│ ↓ ↓ ↓ │
|
|
21
|
-
│ Instance 1 Instance 2 Instance N │
|
|
22
|
-
│ ↓ ↓ ↓ │
|
|
23
|
-
│ └────────────────┼────────────────┘ │
|
|
24
|
-
│ ↓ │
|
|
25
|
-
│ Aggregator │
|
|
26
|
-
│ ↓ │
|
|
27
|
-
│ Execution Summary │
|
|
28
|
-
└─────────────────────────────────────────────────────────────┘
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## 任务分解策略
|
|
32
|
-
|
|
33
|
-
### 独立任务 (Independent)
|
|
34
|
-
|
|
35
|
-
```python
|
|
36
|
-
tasks = [
|
|
37
|
-
{"id": "1", "type": "independent", "command": "npm test -- --testNamePattern=auth"},
|
|
38
|
-
{"id": "2", "type": "independent", "command": "npm test -- --testNamePattern=api"},
|
|
39
|
-
{"id": "3", "type": "independent", "command": "npm test -- --testNamePattern=ui"},
|
|
40
|
-
]
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### 串行任务 (Sequential)
|
|
44
|
-
|
|
45
|
-
```python
|
|
46
|
-
tasks = [
|
|
47
|
-
{"id": "1", "type": "sequential", "command": "npm run build"},
|
|
48
|
-
{"id": "2", "type": "sequential", "command": "npm run test", "depends_on": ["1"]},
|
|
49
|
-
]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### 级联任务 (Cascade)
|
|
53
|
-
|
|
54
|
-
```python
|
|
55
|
-
tasks = [
|
|
56
|
-
{"id": "main", "type": "cascade", "command": "npm run build"},
|
|
57
|
-
{"id": "sub1", "type": "cascade", "trigger": "on_success", "parent": "main", "command": "./deploy.sh staging"},
|
|
58
|
-
{"id": "sub2", "type": "cascade", "trigger": "on_success", "parent": "main", "command": "./notify.sh"},
|
|
59
|
-
]
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## Git Worktree 并行
|
|
63
|
-
|
|
64
|
-
### 创建 Worktree
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
git worktree add ../feature-auth-worktree feature-auth
|
|
68
|
-
git worktree add ../feature-api-worktree feature-api
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### 管理 Worktrees
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
# 列出所有 worktree
|
|
75
|
-
git worktree list
|
|
76
|
-
|
|
77
|
-
# 列出所有 worktree(详细)
|
|
78
|
-
git worktree list --verbose
|
|
79
|
-
|
|
80
|
-
# 移除 worktree
|
|
81
|
-
git worktree remove ../feature-auth-worktree
|
|
82
|
-
|
|
83
|
-
# 清理无效 worktree
|
|
84
|
-
git worktree prune
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### 在 Worktree 中执行任务
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
cd ../feature-auth-worktree
|
|
91
|
-
npm test
|
|
92
|
-
cd ../feature-api-worktree
|
|
93
|
-
npm test
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
## 动态扩展
|
|
97
|
-
|
|
98
|
-
### Scale Out(横向扩展)
|
|
99
|
-
|
|
100
|
-
增加并行实例数量:
|
|
101
|
-
|
|
102
|
-
```python
|
|
103
|
-
# 从 2 个实例扩展到 4 个
|
|
104
|
-
scale_out(max_instances=4)
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
### Scale Up(纵向扩展)
|
|
108
|
-
|
|
109
|
-
提升单个实例规格:
|
|
110
|
-
|
|
111
|
-
```python
|
|
112
|
-
# 切换到更大内存的实例
|
|
113
|
-
scale_up(instance_type="large")
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
## 使用场景
|
|
117
|
-
|
|
118
|
-
### 场景 1:多模块并行测试
|
|
119
|
-
|
|
120
|
-
```
|
|
121
|
-
任务:为 4 个独立模块运行测试
|
|
122
|
-
策略:scale_out with 4 instances
|
|
123
|
-
|
|
124
|
-
→ Instance 1: npm test -- --testNamePattern=module-auth
|
|
125
|
-
→ Instance 2: npm test -- --testNamePattern=module-api
|
|
126
|
-
→ Instance 3: npm test -- --testNamePattern=module-db
|
|
127
|
-
→ Instance 4: npm test -- --testNamePattern=module-ui
|
|
128
|
-
|
|
129
|
-
汇总结果
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### 场景 2:多分支并行开发
|
|
133
|
-
|
|
134
|
-
```
|
|
135
|
-
任务:在 feature-a 和 feature-b 分支上并行开发
|
|
136
|
-
策略:Git worktree
|
|
137
|
-
|
|
138
|
-
→ Worktree 1: feature-a 分支,单独开发
|
|
139
|
-
→ Worktree 2: feature-b 分支,单独开发
|
|
140
|
-
|
|
141
|
-
合并到主分支时解决冲突
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
### 场景 3:构建 + 部署级联
|
|
145
|
-
|
|
146
|
-
```
|
|
147
|
-
任务:构建 → 部署 staging → 部署 prod
|
|
148
|
-
策略:Cascade
|
|
149
|
-
|
|
150
|
-
→ Step 1: npm run build (sequential)
|
|
151
|
-
→ Step 2a: ./deploy.sh staging (cascade on success)
|
|
152
|
-
→ Step 2b: ./run-tests.sh (cascade on success)
|
|
153
|
-
→ Step 3: ./deploy.sh prod (cascade on success of all)
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
## 最佳实践
|
|
157
|
-
|
|
158
|
-
1. **任务拆分粒度**:每个子任务耗时 2-10 分钟最佳
|
|
159
|
-
2. **避免写冲突**:并行任务不要写同一个文件
|
|
160
|
-
3. **共享状态**:使用文件、数据库或消息队列传递
|
|
161
|
-
4. **失败处理策略**:
|
|
162
|
-
- `fail-fast`:一个失败立即停止
|
|
163
|
-
- `fail-continue`:部分失败继续,返回完整报告
|
|
164
|
-
- `retry`:自动重试 N 次
|
|
165
|
-
5. **资源估算**:预估总耗时 = 最长任务时间 + 汇总时间
|
|
166
|
-
|
|
167
|
-
## 与其他模块配合
|
|
168
|
-
|
|
169
|
-
### 与 Verification Loop 配合
|
|
170
|
-
|
|
171
|
-
验证任务天然适合并行执行(多个验证点同时检查)。
|
|
172
|
-
|
|
173
|
-
### 与 TDD Guide 配合
|
|
174
|
-
|
|
175
|
-
TDD 的 red-green-refactor 可用 cascade 串联。
|
|
176
|
-
|
|
177
|
-
### 与 Harness Optimizer 配合
|
|
178
|
-
|
|
179
|
-
根据历史执行数据,自动推荐最优并行策略。
|
|
@@ -1,184 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
version: "0.1.0"
|
|
3
|
-
status: draft
|
|
4
|
-
created: 2026-03-29
|
|
5
|
-
updated: 2026-03-29
|
|
6
|
-
owner: 工程团队
|
|
7
|
-
doc_tier: historical
|
|
8
|
-
last_verified: 2026-04-17
|
|
9
|
-
source_of_truth:
|
|
10
|
-
- ./platform-capability-demo-script.md
|
|
11
|
-
- ./command-and-capability-matrix.md
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
# 平台能力升级演示执行记录
|
|
15
|
-
|
|
16
|
-
> 历史快照(非现行操作手册):本页保留当次演示执行轨迹,不作为当前命令与流程的权威定义。
|
|
17
|
-
> 本页出现的 `validate_library.py` 属于历史命名;当前等价命令是 `node scripts/validate-library.js`。
|
|
18
|
-
|
|
19
|
-
本文记录一条面向“平台能力升级同步”的演示链路,不替代旧的业务场景 demo。它的目标是展示新增命令、角色手册同步、示例补齐和 runtime 说明如何形成闭环。
|
|
20
|
-
|
|
21
|
-
## 1. 场景定义
|
|
22
|
-
|
|
23
|
-
### 背景
|
|
24
|
-
|
|
25
|
-
- 仓库最近新增了一批 specialist 命令、ECC skills、hooks 和 runtime 组件
|
|
26
|
-
- 旧的业务演示仍可用,但无法解释本轮新增的 `/tdd`、`/harness-audit` 与 runtime 机制
|
|
27
|
-
- 需要补一套更适合团队同步和平台汇报的演示材料
|
|
28
|
-
|
|
29
|
-
### 演示目标
|
|
30
|
-
|
|
31
|
-
- 让观众理解当前命令面已经扩展
|
|
32
|
-
- 让观众理解 runtime 是后台机制而不是显式命令
|
|
33
|
-
- 让观众看到文档同步不是单点修改,而是成套收敛
|
|
34
|
-
|
|
35
|
-
## 2. 阶段 1:/team-intake
|
|
36
|
-
|
|
37
|
-
### 输入
|
|
38
|
-
|
|
39
|
-
```text
|
|
40
|
-
/team-intake
|
|
41
|
-
目标:重审平台新增命令、skills、hooks 和文档入口,并补齐使用文档、示例和演示材料
|
|
42
|
-
范围:README、quick start、usage scenarios、examples、角色手册、demo 脚本、demo 执行记录
|
|
43
|
-
不做:修改历史快照文档、调整平台生成逻辑
|
|
44
|
-
约束:旧的业务 demo 需要保留,新增演示材料必须可单独复用
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### 产出
|
|
48
|
-
|
|
49
|
-
| 字段 | 内容 |
|
|
50
|
-
|------|------|
|
|
51
|
-
| 任务类型 | 平台治理与文档同步 |
|
|
52
|
-
| 主体对象 | 命令入口、ECC skills、runtime 说明、角色手册、示例材料 |
|
|
53
|
-
| 风险 | 文档面已扩散到多层入口,容易出现只改总表不改高频页 |
|
|
54
|
-
| 收口要求 | 保留历史文档,新能力另建 evergreen 演示材料 |
|
|
55
|
-
|
|
56
|
-
## 3. 阶段 2:/team-plan
|
|
57
|
-
|
|
58
|
-
### 拆解结果
|
|
59
|
-
|
|
60
|
-
| 模块 | 动作 | 收口位置 |
|
|
61
|
-
|------|------|----------|
|
|
62
|
-
| 总入口 | README、CLAUDE、AGENTS、usage docs 对齐新命令面 | evergreen 文档 |
|
|
63
|
-
| 次级入口 | quick start、prompt recipes、workflow essentials 对齐 | 快速上手与模板 |
|
|
64
|
-
| 角色手册 | 各角色日常操作文档补 `/tdd`、`/harness-audit`、矩阵入口 | 角色层 |
|
|
65
|
-
| 演示材料 | 补平台能力升级剧本与执行记录 | demo 层 |
|
|
66
|
-
| 最终验证 | 逐批无错 + 历史命令 `validate_library.py`(当前等价 `node scripts/validate-library.js`)通过 | 校验层 |
|
|
67
|
-
|
|
68
|
-
### 识别出的关键判断
|
|
69
|
-
|
|
70
|
-
- 适合进入 `/tdd` 的不是“业务逻辑”,而是“平台同步完成标准”
|
|
71
|
-
- 适合进入 `/harness-audit` 的不是单个文档,而是整个平台入口一致性
|
|
72
|
-
|
|
73
|
-
## 4. 阶段 3:/tdd
|
|
74
|
-
|
|
75
|
-
### 定义的完成标准
|
|
76
|
-
|
|
77
|
-
```text
|
|
78
|
-
1. quick start 与 usage scenarios 显式出现 /tdd 和 /harness-audit
|
|
79
|
-
2. specialist 手册能解释这两个入口的适用边界
|
|
80
|
-
3. 角色日常手册能解释何时使用测试先行和平台体检
|
|
81
|
-
4. demo 材料能独立说明 runtime 是后台机制
|
|
82
|
-
5. 仓库校验通过
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
### 价值说明
|
|
86
|
-
|
|
87
|
-
- 把“文档更新”变成“有验证口径的收敛任务”
|
|
88
|
-
- 避免只更新少数入口,导致团队使用路径不一致
|
|
89
|
-
|
|
90
|
-
## 5. 阶段 4:/team-execute
|
|
91
|
-
|
|
92
|
-
### 执行批次
|
|
93
|
-
|
|
94
|
-
#### 批次 A:入口文档与 quick start
|
|
95
|
-
|
|
96
|
-
- 更新 README、CLAUDE、AGENTS
|
|
97
|
-
- 更新 Claude/Codex quick start 与 usage scenarios
|
|
98
|
-
- 新增 [command-and-capability-matrix.md](command-and-capability-matrix.md)
|
|
99
|
-
- 新增 [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
100
|
-
|
|
101
|
-
#### 批次 B:模板、手册与 onboarding
|
|
102
|
-
|
|
103
|
-
- 更新 prompt recipes、workflow essentials、onboarding
|
|
104
|
-
- 更新 specialist playbook 和 quick prompts
|
|
105
|
-
- 更新首个命令 60 秒引导
|
|
106
|
-
|
|
107
|
-
#### 批次 C:角色日常手册
|
|
108
|
-
|
|
109
|
-
- Tech Lead 明确何时用 `/tdd`、`/harness-audit`
|
|
110
|
-
- Product / Project Manager 明确何时前置可测标准
|
|
111
|
-
- Architect / Frontend / Backend / QA 明确测试先行如何介入
|
|
112
|
-
- DevOps 明确平台入口变化后何时做平台体检
|
|
113
|
-
|
|
114
|
-
#### 批次 D:演示材料
|
|
115
|
-
|
|
116
|
-
- 新增 [platform-capability-demo-script.md](platform-capability-demo-script.md)
|
|
117
|
-
- 新增本文,作为平台能力升级的执行记录
|
|
118
|
-
|
|
119
|
-
## 6. 阶段 5:/harness-audit
|
|
120
|
-
|
|
121
|
-
### 体检前观察到的缺口
|
|
122
|
-
|
|
123
|
-
- 新命令已经存在,但模板与角色手册未同步
|
|
124
|
-
- runtime 机制存在,但缺少独立讲解页和演示话术
|
|
125
|
-
- 旧 demo 仍然偏业务流程,无法单独解释本轮能力升级
|
|
126
|
-
|
|
127
|
-
### 体检后的收敛结果
|
|
128
|
-
|
|
129
|
-
| 维度 | 收敛动作 | 状态 |
|
|
130
|
-
|------|----------|------|
|
|
131
|
-
| 命令覆盖 | `/tdd`、`/harness-audit` 已进入 quick start、playbook、角色手册 | 已补齐 |
|
|
132
|
-
| skills 完整度 | `eval-harness`、`continuous-learning`、`cost-aware-llm-pipeline`、`strategic-compact` 已进入矩阵与说明 | 已补齐 |
|
|
133
|
-
| hooks 与 runtime | memory、observe、budget、compact、instinct 已有独立总览页 | 已补齐 |
|
|
134
|
-
| 文档同步 | 主入口、次级入口、角色层、demo 层形成闭环 | 已补齐 |
|
|
135
|
-
| 演示可复用性 | 旧业务 demo 保留,新增平台升级 demo 单独存在 | 已补齐 |
|
|
136
|
-
|
|
137
|
-
## 7. runtime 说明在本次演示中的位置
|
|
138
|
-
|
|
139
|
-
本次演示没有把 runtime 当作“要执行的步骤”,而是把它作为讲解层:
|
|
140
|
-
|
|
141
|
-
- memory persistence:解释会话摘要、决策和待办如何回存
|
|
142
|
-
- observation:解释系统怎样观察工具调用模式
|
|
143
|
-
- cost awareness:解释复杂任务为何要关注预算与成本
|
|
144
|
-
- compact/archive:解释长会话如何防止上下文失控
|
|
145
|
-
- instinct learning:解释持续学习为何属于平台增强能力
|
|
146
|
-
|
|
147
|
-
## 8. 校验结果
|
|
148
|
-
|
|
149
|
-
### 文档静态检查
|
|
150
|
-
|
|
151
|
-
- 本轮新增与修改的 demo/role/onboarding 文档无错误
|
|
152
|
-
|
|
153
|
-
### 仓库校验
|
|
154
|
-
|
|
155
|
-
```text
|
|
156
|
-
Validation passed.
|
|
157
|
-
- Roles: 8
|
|
158
|
-
- Shared skills: 3
|
|
159
|
-
- ECC skills: 9
|
|
160
|
-
- Private overlay skills: not shipped in public repo
|
|
161
|
-
- Specialist agents: 27
|
|
162
|
-
- Generated artifacts: 70
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
## 9. 演示结论
|
|
166
|
-
|
|
167
|
-
### 结论 1
|
|
168
|
-
|
|
169
|
-
本轮平台升级不只是“新增几个文件”,而是公开命令、ECC skills、runtime 和文档入口四层同步扩展。
|
|
170
|
-
|
|
171
|
-
### 结论 2
|
|
172
|
-
|
|
173
|
-
`/tdd` 和 `/harness-audit` 已经从“存在于仓库里”提升为“存在于用户路径里”。
|
|
174
|
-
|
|
175
|
-
### 结论 3
|
|
176
|
-
|
|
177
|
-
runtime 能力已有单独说明和 demo 话术,不再需要依赖听众从 hooks 目录自行推断。
|
|
178
|
-
|
|
179
|
-
## 10. 推荐搭配材料
|
|
180
|
-
|
|
181
|
-
- [platform-capability-demo-script.md](platform-capability-demo-script.md)
|
|
182
|
-
- [command-and-capability-matrix.md](command-and-capability-matrix.md)
|
|
183
|
-
- [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
184
|
-
- [demo-execution-log.md](demo-execution-log.md)
|
|
@@ -1,192 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
version: "0.1.0"
|
|
3
|
-
status: draft
|
|
4
|
-
created: 2026-03-29
|
|
5
|
-
updated: 2026-03-29
|
|
6
|
-
owner: 工程团队
|
|
7
|
-
doc_tier: historical
|
|
8
|
-
last_verified: 2026-04-17
|
|
9
|
-
source_of_truth:
|
|
10
|
-
- ./command-and-capability-matrix.md
|
|
11
|
-
- ./runtime-capabilities-overview.md
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
# 平台能力升级演示剧本
|
|
15
|
-
|
|
16
|
-
> 历史快照(非现行操作手册):本页用于保留当时演示叙事,不作为当前安装或校验命令的权威来源。
|
|
17
|
-
> 本页出现的 `validate_library.py` 属于历史命名;当前等价命令是 `node scripts/validate-library.js`。
|
|
18
|
-
|
|
19
|
-
本文是一份可直接照着讲的演示脚本,专门用于展示本轮新增的 `/tdd`、`/harness-audit`,以及 memory、observe、budget、compact、instinct 等 runtime 能力。
|
|
20
|
-
|
|
21
|
-
如果你需要先看命令和能力总表,配合阅读 [command-and-capability-matrix.md](command-and-capability-matrix.md)。如果你需要看后台机制定义,配合阅读 [runtime-capabilities-overview.md](runtime-capabilities-overview.md)。
|
|
22
|
-
|
|
23
|
-
## 1. 演示目标
|
|
24
|
-
|
|
25
|
-
- 说明平台现在不只有主链,还有测试先行和平台体检入口
|
|
26
|
-
- 说明 runtime 能力是后台自动生效,不是手工命令
|
|
27
|
-
- 说明文档、示例、角色手册和 quick start 已同步到新能力面
|
|
28
|
-
|
|
29
|
-
## 2. 适用对象
|
|
30
|
-
|
|
31
|
-
- 新接入项目团队
|
|
32
|
-
- 需要做平台介绍的 Tech Lead
|
|
33
|
-
- 需要做阶段汇报的工程负责人
|
|
34
|
-
- 需要解释 ECC Harness Layer 的讲解人
|
|
35
|
-
|
|
36
|
-
## 3. 演示时长建议
|
|
37
|
-
|
|
38
|
-
- 5 分钟:只讲命令面变化
|
|
39
|
-
- 10 分钟:讲命令面 + runtime
|
|
40
|
-
- 15 分钟:完整走一遍“发现缺口 -> 测试先行 -> 文档补齐 -> 平台体检”的闭环
|
|
41
|
-
|
|
42
|
-
## 4. 演示脚本
|
|
43
|
-
|
|
44
|
-
### Step 1. 用 1 分钟讲清平台当前新增了什么
|
|
45
|
-
|
|
46
|
-
建议讲法:
|
|
47
|
-
|
|
48
|
-
```text
|
|
49
|
-
这次平台不是只新增了几个 runbook,而是扩展了三层能力:
|
|
50
|
-
第一层是公开命令,新增了 /tdd 和 /harness-audit;
|
|
51
|
-
第二层是 ECC skills,新增了 eval-harness、continuous-learning、cost-aware-llm-pipeline、strategic-compact 等能力;
|
|
52
|
-
第三层是 runtime 机制,包括 memory persistence、observation、instinct learning、context budget 与 compact/archive。
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
配套材料:
|
|
56
|
-
|
|
57
|
-
- [command-and-capability-matrix.md](command-and-capability-matrix.md)
|
|
58
|
-
- [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
59
|
-
|
|
60
|
-
### Step 2. 用 `/team-intake` 讲清当前平台治理任务是什么
|
|
61
|
-
|
|
62
|
-
建议输入:
|
|
63
|
-
|
|
64
|
-
```text
|
|
65
|
-
/team-intake
|
|
66
|
-
目标:审视近期新增命令、skills、hooks 与文档入口是否同步
|
|
67
|
-
范围:README、quick start、usage scenarios、examples、角色手册
|
|
68
|
-
不做:修改历史快照文档、重构平台代码
|
|
69
|
-
约束:需要保留旧的业务演示,同时补一套面向新增能力的 demo 材料
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
讲解重点:
|
|
73
|
-
|
|
74
|
-
- 这不是业务需求,而是平台治理任务
|
|
75
|
-
- 需要区分 evergreen 文档和历史快照文档
|
|
76
|
-
- 从一开始就说明“不做什么”,避免演示中被带偏
|
|
77
|
-
|
|
78
|
-
### Step 3. 用 `/team-plan` 说明这类平台治理任务如何拆解
|
|
79
|
-
|
|
80
|
-
建议输入:
|
|
81
|
-
|
|
82
|
-
```text
|
|
83
|
-
/team-plan
|
|
84
|
-
基于当前 intake 结果,拆出文档刷新、示例补齐、角色手册同步、演示材料补齐和最终校验的动作清单。
|
|
85
|
-
输出必须包含:依赖、收口节点、哪些事项适合进入 /tdd,哪些事项适合最终进入 /harness-audit。
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
讲解重点:
|
|
89
|
-
|
|
90
|
-
- 新增能力同步不是“一次性改 README”
|
|
91
|
-
- 要分入口文档、次级模板、角色手册、demo 材料四层推进
|
|
92
|
-
|
|
93
|
-
### Step 4. 用 `/tdd` 讲“测试先行”不只用于代码,也能用于平台文档收敛
|
|
94
|
-
|
|
95
|
-
建议输入:
|
|
96
|
-
|
|
97
|
-
```text
|
|
98
|
-
/tdd
|
|
99
|
-
基于当前 /team-plan 结果,先定义这轮平台能力同步的完成标准。
|
|
100
|
-
至少覆盖:
|
|
101
|
-
1. quick start 明确出现 /tdd 与 /harness-audit
|
|
102
|
-
2. specialist 与角色手册能解释何时用这两个入口
|
|
103
|
-
3. 演示材料能独立说明 runtime 是后台机制,不是显式命令
|
|
104
|
-
4. 历史命令 `validate_library.py`(当前等价 `node scripts/validate-library.js`)最终通过
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
讲解重点:
|
|
108
|
-
|
|
109
|
-
- `/tdd` 的核心不是只能写测试代码,而是先把“什么算完成”说清楚
|
|
110
|
-
- 对平台文档治理来说,它能减少返工和漏项
|
|
111
|
-
- 如果需要更强的验证闭环,可以搭配 `eval-harness`
|
|
112
|
-
|
|
113
|
-
### Step 5. 用 `/team-execute` 讲实际收敛动作
|
|
114
|
-
|
|
115
|
-
建议讲法:
|
|
116
|
-
|
|
117
|
-
```text
|
|
118
|
-
执行阶段不再只是改一两个文件,而是分批补入口、补角色手册、补示例、补 demo。
|
|
119
|
-
每一批都先说明目标,再批量修改,再局部检查,最后统一校验。
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
可展示的材料:
|
|
123
|
-
|
|
124
|
-
- [claude-quick-start.md](claude-quick-start.md)
|
|
125
|
-
- [codex-quick-start.md](codex-quick-start.md)
|
|
126
|
-
- [specialist-commands-playbook.md](specialist-commands-playbook.md)
|
|
127
|
-
- [tech-lead-daily-operations.md](tech-lead-daily-operations.md)
|
|
128
|
-
|
|
129
|
-
### Step 6. 用 `/harness-audit` 讲平台体检为什么是新增关键入口
|
|
130
|
-
|
|
131
|
-
建议输入:
|
|
132
|
-
|
|
133
|
-
```text
|
|
134
|
-
/harness-audit
|
|
135
|
-
请从命令覆盖、skills 完整度、hooks 有效性、文档同步、集成深度五个方向审视当前平台。
|
|
136
|
-
输出必须区分:
|
|
137
|
-
1. 需要立即补齐的问题
|
|
138
|
-
2. 可下一轮处理的问题
|
|
139
|
-
3. 仅记录观察的问题
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
讲解重点:
|
|
143
|
-
|
|
144
|
-
- `/harness-audit` 面向平台自身,不替代业务任务的 review 或 release
|
|
145
|
-
- 它适合在仓库刚新增命令、skills、hooks、安装入口或大量 runbook 后使用
|
|
146
|
-
- 它的价值是把零散缺口收敛成统一治理动作
|
|
147
|
-
|
|
148
|
-
### Step 7. 单独用 2 分钟说明 runtime 是怎样工作的
|
|
149
|
-
|
|
150
|
-
建议讲法:
|
|
151
|
-
|
|
152
|
-
```text
|
|
153
|
-
这轮新增的 runtime 能力不是你每次都要手动执行的命令。
|
|
154
|
-
它们包括会话摘要回存、行为观察、成本记录、预算预警、上下文压缩和 instinct 学习。
|
|
155
|
-
它们在后台帮助长会话保持稳定,但不会替代主链和 specialist 的显式决策入口。
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
建议配套展示:
|
|
159
|
-
|
|
160
|
-
- [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
161
|
-
- [ecc-harness-usage.md](ecc-harness-usage.md)
|
|
162
|
-
|
|
163
|
-
### Step 8. 用校验结果收尾
|
|
164
|
-
|
|
165
|
-
建议讲法:
|
|
166
|
-
|
|
167
|
-
```text
|
|
168
|
-
文档和演示补齐后,最终仍要回到平台校验脚本。
|
|
169
|
-
只要历史命令 `validate_library.py`(当前等价 `node scripts/validate-library.js`)通过,就说明角色、skills、agents 和生成产物基线没有被破坏。
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
## 5. 建议演示顺序
|
|
173
|
-
|
|
174
|
-
1. 先展示 [command-and-capability-matrix.md](command-and-capability-matrix.md)
|
|
175
|
-
2. 再展示 [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
176
|
-
3. 然后讲 `/team-intake` 和 `/team-plan`
|
|
177
|
-
4. 再讲 `/tdd`
|
|
178
|
-
5. 再讲 `/team-execute`
|
|
179
|
-
6. 最后讲 `/harness-audit` 和校验结果
|
|
180
|
-
|
|
181
|
-
## 6. 观众常见问题
|
|
182
|
-
|
|
183
|
-
- `/tdd` 是不是只适合代码开发:不是,它适合先定义完成标准的场景
|
|
184
|
-
- `/harness-audit` 能不能替代 `/team-review`:不能,它面向平台治理,不面向业务放行
|
|
185
|
-
- runtime 能力是不是要手动触发:不是,runtime 是后台机制
|
|
186
|
-
- 为什么还保留旧 demo:因为旧 demo 解释业务主链,新 demo 解释能力升级
|
|
187
|
-
|
|
188
|
-
## 7. 演示后建议发给观众的材料
|
|
189
|
-
|
|
190
|
-
- [command-and-capability-matrix.md](command-and-capability-matrix.md)
|
|
191
|
-
- [runtime-capabilities-overview.md](runtime-capabilities-overview.md)
|
|
192
|
-
- [platform-capability-demo-execution-log.md](platform-capability-demo-execution-log.md)
|
|
@@ -1,136 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
version: "0.1.0"
|
|
3
|
-
status: draft
|
|
4
|
-
created: 2026-03-29
|
|
5
|
-
updated: 2026-03-29
|
|
6
|
-
owner: 工程团队
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# 插件与扩展平台演示执行记录
|
|
10
|
-
|
|
11
|
-
本文记录一条插件 / 扩展平台演示路径,重点展示团队如何把命令入口、配置项、宿主兼容和安装路径收敛成可验证的交付链路。
|
|
12
|
-
|
|
13
|
-
## 1. 场景定义
|
|
14
|
-
|
|
15
|
-
### 背景
|
|
16
|
-
|
|
17
|
-
- 仓库当前维护 extension / plugin 的命令入口、配置项和安装说明
|
|
18
|
-
- 团队准备新增一个宿主命令入口,并同步补齐兼容与升级说明
|
|
19
|
-
- 希望避免“功能能用,但安装、升级和禁用态无人解释”的交付状态
|
|
20
|
-
|
|
21
|
-
### 演示目标
|
|
22
|
-
|
|
23
|
-
- 让观众理解命令面、配置面和安装路径是三个不同层次
|
|
24
|
-
- 让观众看到 `/tdd` 如何前置定义兼容标准
|
|
25
|
-
- 让观众看到 `/verify` 如何把安装和升级验证结果正式回写到 review
|
|
26
|
-
|
|
27
|
-
## 2. 阶段 1:/team-intake
|
|
28
|
-
|
|
29
|
-
### 输入
|
|
30
|
-
|
|
31
|
-
```text
|
|
32
|
-
/team-intake
|
|
33
|
-
目标:为插件仓库新增命令入口并补齐安装、配置与兼容性说明
|
|
34
|
-
范围:命令、配置项、集成点、安装文档、测试计划
|
|
35
|
-
不做:无关业务服务改造
|
|
36
|
-
约束:必须说明宿主版本边界、升级路径、禁用态和失败回退行为
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### 产出
|
|
40
|
-
|
|
41
|
-
| 字段 | 内容 |
|
|
42
|
-
|------|------|
|
|
43
|
-
| 任务类型 | 插件 / 扩展交付 |
|
|
44
|
-
| 主体对象 | 命令入口、配置项、宿主集成、安装路径 |
|
|
45
|
-
| 主要风险 | 兼容矩阵不清、升级失败、安装路径失联 |
|
|
46
|
-
| 收口要求 | review 必须承接兼容与安装验证结果 |
|
|
47
|
-
|
|
48
|
-
## 3. 阶段 2:/team-plan
|
|
49
|
-
|
|
50
|
-
### 拆解结果
|
|
51
|
-
|
|
52
|
-
| 模块 | 动作 | 收口位置 |
|
|
53
|
-
|------|------|----------|
|
|
54
|
-
| 命令面 | 新增或调整命令入口 | 代码 / docs |
|
|
55
|
-
| 配置面 | 定义配置项与默认值 | 代码 / docs |
|
|
56
|
-
| 安装面 | 更新安装、升级、禁用路径 | docs / verify |
|
|
57
|
-
| 兼容面 | 明确宿主版本与例外项 | verify / review |
|
|
58
|
-
|
|
59
|
-
### 关键判断
|
|
60
|
-
|
|
61
|
-
- 命令入口变更必须同步到安装和配置说明
|
|
62
|
-
- 兼容矩阵需要进入 verify,而不是只口头说明
|
|
63
|
-
|
|
64
|
-
## 4. 阶段 3:/tdd
|
|
65
|
-
|
|
66
|
-
### 定义的完成标准
|
|
67
|
-
|
|
68
|
-
```text
|
|
69
|
-
1. 命令入口、配置边界和安装路径说明清晰
|
|
70
|
-
2. 宿主兼容矩阵有正式记录
|
|
71
|
-
3. verify 能汇总安装、升级、禁用态和回退结果
|
|
72
|
-
4. review 能明确说明阻塞项与例外
|
|
73
|
-
5. 仓库校验通过
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
## 5. 阶段 4:/team-execute
|
|
77
|
-
|
|
78
|
-
### 执行批次
|
|
79
|
-
|
|
80
|
-
#### 批次 A:命令与配置
|
|
81
|
-
|
|
82
|
-
- 调整命令入口
|
|
83
|
-
- 调整配置项与默认值
|
|
84
|
-
|
|
85
|
-
#### 批次 B:安装与升级
|
|
86
|
-
|
|
87
|
-
- 更新安装路径
|
|
88
|
-
- 更新升级与禁用说明
|
|
89
|
-
|
|
90
|
-
#### 批次 C:兼容收口
|
|
91
|
-
|
|
92
|
-
- 汇总宿主版本矩阵
|
|
93
|
-
- 整理 verify 所需证据
|
|
94
|
-
|
|
95
|
-
## 6. 阶段 5:/verify
|
|
96
|
-
|
|
97
|
-
### Verify 结果
|
|
98
|
-
|
|
99
|
-
| 检查项 | 判断 |
|
|
100
|
-
|--------|------|
|
|
101
|
-
| 命令入口 | 已确认 |
|
|
102
|
-
| 配置项 | 已确认 |
|
|
103
|
-
| 安装路径 | 已确认 |
|
|
104
|
-
| 升级 / 禁用态 | 已确认 |
|
|
105
|
-
| 兼容矩阵 | 已确认 |
|
|
106
|
-
|
|
107
|
-
## 7. 阶段 6:/team-review
|
|
108
|
-
|
|
109
|
-
### Review 结论
|
|
110
|
-
|
|
111
|
-
- 当前交付已经覆盖命令、配置、安装和兼容四层
|
|
112
|
-
- 若仍有例外项,应明确标记为下一轮优化或限制说明
|
|
113
|
-
|
|
114
|
-
## 8. 校验结果
|
|
115
|
-
|
|
116
|
-
### 文档静态检查
|
|
117
|
-
|
|
118
|
-
- 本轮新增 walkthrough、demo script 与 execution log 无错误
|
|
119
|
-
|
|
120
|
-
### 仓库校验
|
|
121
|
-
|
|
122
|
-
```text
|
|
123
|
-
Validation passed.
|
|
124
|
-
- Roles: 8
|
|
125
|
-
- Shared skills: 3
|
|
126
|
-
- ECC skills: 9
|
|
127
|
-
- Private overlay skills: not shipped in public repo
|
|
128
|
-
- Specialist agents: 27
|
|
129
|
-
- Generated artifacts: 70
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
## 9. 推荐搭配材料
|
|
133
|
-
|
|
134
|
-
- [plugin-extension-platform-demo-script.md](plugin-extension-platform-demo-script.md)
|
|
135
|
-
- [plugin-extension-platform-walkthrough.md](plugin-extension-platform-walkthrough.md)
|
|
136
|
-
- [../../examples/plugin-extension-platform-CLAUDE.md](../../examples/plugin-extension-platform-CLAUDE.md)
|