@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.
Files changed (236) hide show
  1. package/README.md +16 -20
  2. package/bin/lib/install-surface.js +3 -3
  3. package/bin/lib/source-installer.js +2 -2
  4. package/commands/team-help.md +2 -2
  5. package/commands/team-plan.md +1 -1
  6. package/commands/update-codemaps.md +3 -3
  7. package/manifests/install-components.json +1 -1
  8. package/manifests/install-modules.json +17 -3
  9. package/manifests/install-profiles.json +2 -0
  10. package/package.json +6 -3
  11. package/schemas/ecc-install-config.schema.json +6 -1
  12. package/schemas/install-modules.schema.json +4 -1
  13. package/scripts/codegraph-preflight.js +179 -0
  14. package/scripts/gitnexus-preflight.js +8 -0
  15. package/scripts/install-apply.js +10 -8
  16. package/scripts/install-codegraph.js +158 -0
  17. package/scripts/install-plan.js +28 -11
  18. package/scripts/lib/install/apply.js +256 -5
  19. package/scripts/lib/install/request.js +3 -2
  20. package/scripts/lib/install-audit-manifest.js +3 -0
  21. package/scripts/lib/install-executor.js +14 -5
  22. package/scripts/lib/install-lifecycle.js +2 -2
  23. package/scripts/lib/install-manifests.js +23 -4
  24. package/scripts/lib/install-targets/codex-home.js +187 -1
  25. package/scripts/lib/install-targets/opencode-home.js +135 -2
  26. package/scripts/lib/install-targets/registry.js +23 -1
  27. package/scripts/lib/release-health.js +19 -4
  28. package/scripts/lib/team-skills-data.json +6 -6
  29. package/scripts/release-health-summary.js +1 -1
  30. package/scripts/workflow-help.js +3 -3
  31. package/skills/codegraph/SKILL.md +57 -0
  32. package/skills/codegraph/agents/openai.yaml +4 -0
  33. package/docs/.vitepress/config.mts +0 -199
  34. package/docs/adr/ADR-001-doc-architecture-integration.md +0 -33
  35. package/docs/guides/README.md +0 -5
  36. package/docs/guides/installation.md +0 -33
  37. package/docs/guides/user-guide.md +0 -36
  38. package/docs/index.md +0 -65
  39. package/docs/memory/backlog.md +0 -10
  40. package/docs/memory/decisions.md +0 -43
  41. package/docs/memory/lessons-learned.md +0 -87
  42. package/docs/plans/2026-04-03-python-remnants-audit.md +0 -265
  43. package/docs/plans/2026-04-03-scripts-python-to-js-migration.md +0 -372
  44. package/docs/plans/2026-04-03-solo-delivery-execution-checklist.md +0 -413
  45. package/docs/plans/2026-04-03-solo-delivery-gap-plan.md +0 -377
  46. package/docs/plans/2026-04-03-team-skills-workflow-gates.md +0 -548
  47. package/docs/plans/2026-04-21-open-source-readiness-gap-plan.md +0 -217
  48. package/docs/plans/llm-surface-reduction-audit.md +0 -147
  49. package/docs/plans/llm-surface-reduction-execution-checklist.md +0 -217
  50. package/docs/plans/llm-surface-reduction-execution-history.md +0 -124
  51. package/docs/plans/team-skills-platform-migration.md +0 -54
  52. package/docs/presentation/README.md +0 -42
  53. package/docs/presentation/audience-presentation-route-map.md +0 -84
  54. package/docs/presentation/executive-briefing-talk-track.md +0 -50
  55. package/docs/presentation/generate_capability_matrix.py +0 -396
  56. package/docs/presentation/generate_ppt.py +0 -354
  57. package/docs/presentation/implementation-onboarding-brief.md +0 -38
  58. package/docs/presentation/presentation-talk-track.md +0 -97
  59. package/docs/presentation/vertical-scenario-route-map.md +0 -99
  60. package/docs/presentation/workshop-facilitator-guide.md +0 -47
  61. package/docs/runbooks/actionlint-workflow-gates.md +0 -80
  62. package/docs/runbooks/agent-governance.md +0 -131
  63. package/docs/runbooks/ai-eval-platform-demo-execution-log.md +0 -147
  64. package/docs/runbooks/ai-eval-platform-demo-script.md +0 -136
  65. package/docs/runbooks/ai-eval-platform-walkthrough.md +0 -113
  66. package/docs/runbooks/ai-pr-review-automation.md +0 -56
  67. package/docs/runbooks/api-breaking-change-gates.md +0 -58
  68. package/docs/runbooks/api-design-evolution-walkthrough.md +0 -42
  69. package/docs/runbooks/api-lint-gates.md +0 -57
  70. package/docs/runbooks/api-mocking-strategy-and-lifecycle-guide.md +0 -47
  71. package/docs/runbooks/architect-daily-operations.md +0 -63
  72. package/docs/runbooks/architect-design-conversation-example.md +0 -83
  73. package/docs/runbooks/artifact-attestation-gates.md +0 -75
  74. package/docs/runbooks/artifact-persistence.md +0 -257
  75. package/docs/runbooks/backend-engineer-daily-operations.md +0 -63
  76. package/docs/runbooks/batch-optimization-completion-checklist.md +0 -104
  77. package/docs/runbooks/biz-service-designer-end-to-end-conversation-example.md +0 -5
  78. package/docs/runbooks/biz-service-designer-toolkit.md +0 -5
  79. package/docs/runbooks/bug-fix-complete-walkthrough.md +0 -60
  80. package/docs/runbooks/build-failure-recovery-walkthrough.md +0 -40
  81. package/docs/runbooks/canary-decision-matrix.md +0 -41
  82. package/docs/runbooks/canary-staging-release-walkthrough.md +0 -46
  83. package/docs/runbooks/checkov-iac-gates.md +0 -104
  84. package/docs/runbooks/claude-code-review-workflow.md +0 -72
  85. package/docs/runbooks/claude-conversation-prompt-recipes.md +0 -132
  86. package/docs/runbooks/claude-end-to-end-conversation-example.md +0 -198
  87. package/docs/runbooks/claude-feature-development-guide.md +0 -112
  88. package/docs/runbooks/claude-quick-start.md +0 -227
  89. package/docs/runbooks/claude-usage-scenarios.md +0 -176
  90. package/docs/runbooks/code-review-collaboration-walkthrough.md +0 -65
  91. package/docs/runbooks/codeql-pr-security-gates.md +0 -64
  92. package/docs/runbooks/codex-end-to-end-conversation-example.md +0 -166
  93. package/docs/runbooks/codex-multi-agent-orchestration.md +0 -65
  94. package/docs/runbooks/codex-parallel-prompt-recipes.md +0 -131
  95. package/docs/runbooks/codex-quick-start.md +0 -223
  96. package/docs/runbooks/codex-usage-scenarios.md +0 -168
  97. package/docs/runbooks/codex-workflow-essentials.md +0 -88
  98. package/docs/runbooks/command-and-capability-matrix.md +0 -162
  99. package/docs/runbooks/conftest-policy-gates.md +0 -84
  100. package/docs/runbooks/consumer-driven-contract-testing-with-mock-alignment.md +0 -45
  101. package/docs/runbooks/contract-testing-playbook.md +0 -78
  102. package/docs/runbooks/cosign-signing-gates.md +0 -71
  103. package/docs/runbooks/cross-role-issue-triage-walkthrough.md +0 -47
  104. package/docs/runbooks/cursor-quick-start.md +0 -123
  105. package/docs/runbooks/custom-overlay.md +0 -115
  106. package/docs/runbooks/data-ml-pipeline-demo-execution-log.md +0 -141
  107. package/docs/runbooks/data-ml-pipeline-demo-script.md +0 -102
  108. package/docs/runbooks/data-ml-pipeline-walkthrough.md +0 -119
  109. package/docs/runbooks/data-observability-quality-demo-execution-log.md +0 -36
  110. package/docs/runbooks/data-observability-quality-demo-script.md +0 -42
  111. package/docs/runbooks/data-observability-quality-walkthrough.md +0 -86
  112. package/docs/runbooks/demo-deliverables-overview.md +0 -278
  113. package/docs/runbooks/demo-execution-log.md +0 -530
  114. package/docs/runbooks/demo-scenario.md +0 -129
  115. package/docs/runbooks/dependency-review-gates.md +0 -63
  116. package/docs/runbooks/dependency-update-automation.md +0 -83
  117. package/docs/runbooks/design-md-workflow.md +0 -185
  118. package/docs/runbooks/devops-engineer-daily-operations.md +0 -60
  119. package/docs/runbooks/devops-release-conversation-example.md +0 -88
  120. package/docs/runbooks/doc-architecture-integration.md +0 -59
  121. package/docs/runbooks/doc-architecture-quick-start.md +0 -122
  122. package/docs/runbooks/document-execution-audit.md +0 -32
  123. package/docs/runbooks/documentation-update-walkthrough.md +0 -37
  124. package/docs/runbooks/ecc-harness-usage.md +0 -93
  125. package/docs/runbooks/error-experience-usage.md +0 -116
  126. package/docs/runbooks/evolution-usage.md +0 -162
  127. package/docs/runbooks/executive-value-one-page.md +0 -55
  128. package/docs/runbooks/external-capability-approval-and-enablement-workflow.md +0 -39
  129. package/docs/runbooks/external-capability-intake.md +0 -160
  130. package/docs/runbooks/first-team-command-60-seconds.md +0 -96
  131. package/docs/runbooks/first-team-workflow-walkthrough.md +0 -245
  132. package/docs/runbooks/frontend-backend-integration-acceptance-checklist.md +0 -46
  133. package/docs/runbooks/frontend-backend-parallel-integration-walkthrough.md +0 -48
  134. package/docs/runbooks/frontend-bugfix-one-page.md +0 -82
  135. package/docs/runbooks/frontend-engineer-daily-operations.md +0 -60
  136. package/docs/runbooks/frontend-enterprise-style-profile.md +0 -5
  137. package/docs/runbooks/frontend-governance.md +0 -47
  138. package/docs/runbooks/frontend-refactor-walkthrough.md +0 -42
  139. package/docs/runbooks/git-pr-workflow.md +0 -63
  140. package/docs/runbooks/github-actions-supply-chain-demo-execution-log.md +0 -158
  141. package/docs/runbooks/github-actions-supply-chain-demo-script.md +0 -150
  142. package/docs/runbooks/github-actions-supply-chain-walkthrough.md +0 -117
  143. package/docs/runbooks/github-token-permissions-baseline.md +0 -92
  144. package/docs/runbooks/gitlab-manual-pipeline-release.md +0 -5
  145. package/docs/runbooks/gitlab-release-integration-playbook.md +0 -5
  146. package/docs/runbooks/gitnexus-code-intelligence-usage.md +0 -133
  147. package/docs/runbooks/graphify-knowledge-graph-usage.md +0 -88
  148. package/docs/runbooks/handoff-filling-guide-with-examples.md +0 -70
  149. package/docs/runbooks/handoff-governance.md +0 -250
  150. package/docs/runbooks/helm-unittest-playbook.md +0 -101
  151. package/docs/runbooks/hotfix-emergency-release-walkthrough.md +0 -60
  152. package/docs/runbooks/iac-kubernetes-platform-demo-execution-log.md +0 -144
  153. package/docs/runbooks/iac-kubernetes-platform-demo-script.md +0 -130
  154. package/docs/runbooks/iac-kubernetes-platform-walkthrough.md +0 -120
  155. package/docs/runbooks/implementation-onboarding-reading-path.md +0 -67
  156. package/docs/runbooks/in-toto-attestation-framework.md +0 -94
  157. package/docs/runbooks/incident-severity-triage-tree.md +0 -43
  158. package/docs/runbooks/incident-triage-one-page.md +0 -65
  159. package/docs/runbooks/internal-developer-platform-demo-execution-log.md +0 -36
  160. package/docs/runbooks/internal-developer-platform-demo-script.md +0 -42
  161. package/docs/runbooks/internal-developer-platform-walkthrough.md +0 -91
  162. package/docs/runbooks/karpathy-guidelines-usage.md +0 -27
  163. package/docs/runbooks/kubeconform-schema-gates.md +0 -100
  164. package/docs/runbooks/kubectl-server-dry-run-gates.md +0 -103
  165. package/docs/runbooks/kyverno-policy-gates.md +0 -90
  166. package/docs/runbooks/langfuse-and-observability-integration-guide.md +0 -43
  167. package/docs/runbooks/langfuse-coding-trace.md +0 -44
  168. package/docs/runbooks/mobile-miniapp-delivery-walkthrough.md +0 -112
  169. package/docs/runbooks/mobile-miniapp-demo-execution-log.md +0 -139
  170. package/docs/runbooks/mobile-miniapp-demo-script.md +0 -129
  171. package/docs/runbooks/multi-service-backend-integration-walkthrough.md +0 -61
  172. package/docs/runbooks/open-design-integration.md +0 -163
  173. package/docs/runbooks/open-source-release-checklist.md +0 -90
  174. package/docs/runbooks/opencode-quick-start.md +0 -128
  175. package/docs/runbooks/parallel-development-coordination-walkthrough.md +0 -47
  176. package/docs/runbooks/parallel-execution-usage.md +0 -179
  177. package/docs/runbooks/platform-capability-demo-execution-log.md +0 -184
  178. package/docs/runbooks/platform-capability-demo-script.md +0 -192
  179. package/docs/runbooks/plugin-extension-platform-demo-execution-log.md +0 -136
  180. package/docs/runbooks/plugin-extension-platform-demo-script.md +0 -102
  181. package/docs/runbooks/plugin-extension-platform-walkthrough.md +0 -111
  182. package/docs/runbooks/policy-controller-gates.md +0 -75
  183. package/docs/runbooks/post-rollback-verification-checklist.md +0 -37
  184. package/docs/runbooks/pre-release-checklist.md +0 -50
  185. package/docs/runbooks/product-manager-clarification-conversation-example.md +0 -90
  186. package/docs/runbooks/product-manager-daily-operations.md +0 -60
  187. package/docs/runbooks/production-incident-response-walkthrough.md +0 -50
  188. package/docs/runbooks/project-claude-design-rationale.md +0 -188
  189. package/docs/runbooks/project-manager-daily-operations.md +0 -61
  190. package/docs/runbooks/project-manager-planning-conversation-example.md +0 -82
  191. package/docs/runbooks/project-onboarding.md +0 -452
  192. package/docs/runbooks/qa-engineer-daily-operations.md +0 -63
  193. package/docs/runbooks/qa-review-conversation-example.md +0 -87
  194. package/docs/runbooks/release-closure-one-page.md +0 -65
  195. package/docs/runbooks/release-governance-reading-path.md +0 -56
  196. package/docs/runbooks/release-notes-automation.md +0 -48
  197. package/docs/runbooks/release-rollback-recovery-walkthrough.md +0 -47
  198. package/docs/runbooks/requirement-clarity-and-scope-walkthrough.md +0 -46
  199. package/docs/runbooks/reviewdog-pr-gates.md +0 -49
  200. package/docs/runbooks/role-prompt-recipes.md +0 -130
  201. package/docs/runbooks/rtk-integration-intake.md +0 -45
  202. package/docs/runbooks/rtk-token-optimization-usage.md +0 -107
  203. package/docs/runbooks/runner-egress-hardening.md +0 -81
  204. package/docs/runbooks/runtime-capabilities-overview.md +0 -113
  205. package/docs/runbooks/sbom-generation-gates.md +0 -71
  206. package/docs/runbooks/scorecard-supply-chain-gates.md +0 -82
  207. package/docs/runbooks/secret-scanning-gates.md +0 -85
  208. package/docs/runbooks/security-compliance-platform-demo-execution-log.md +0 -36
  209. package/docs/runbooks/security-compliance-platform-demo-script.md +0 -49
  210. package/docs/runbooks/security-compliance-platform-walkthrough.md +0 -98
  211. package/docs/runbooks/slsa-generator-patterns.md +0 -73
  212. package/docs/runbooks/slsa-verification-gates.md +0 -75
  213. package/docs/runbooks/solo-delivery-mode.md +0 -142
  214. package/docs/runbooks/solo-delivery-one-page.md +0 -111
  215. package/docs/runbooks/specialist-commands-playbook.md +0 -85
  216. package/docs/runbooks/sub-agent-invocation-map.md +0 -144
  217. package/docs/runbooks/system-architecture-design-walkthrough.md +0 -49
  218. package/docs/runbooks/team-closeout-example.md +0 -73
  219. package/docs/runbooks/team-command-output-contracts.md +0 -358
  220. package/docs/runbooks/team-commands-quick-prompts.md +0 -125
  221. package/docs/runbooks/team-execute-example.md +0 -63
  222. package/docs/runbooks/team-handoff-example.md +0 -49
  223. package/docs/runbooks/team-intake-example.md +0 -70
  224. package/docs/runbooks/team-plan-example.md +0 -62
  225. package/docs/runbooks/team-release-example.md +0 -63
  226. package/docs/runbooks/team-review-example.md +0 -61
  227. package/docs/runbooks/team-skills-test-run.md +0 -184
  228. package/docs/runbooks/team-skills-usage.md +0 -336
  229. package/docs/runbooks/team-training-reading-path.md +0 -64
  230. package/docs/runbooks/tech-lead-closure-conversation-example.md +0 -78
  231. package/docs/runbooks/tech-lead-daily-operations.md +0 -67
  232. package/docs/runbooks/trivy-security-gates.md +0 -79
  233. package/docs/runbooks/troubleshooting.md +0 -234
  234. package/docs/runbooks/vertical-scenario-capability-matrix.md +0 -107
  235. package/docs/runbooks/witness-policy-gates.md +0 -78
  236. package/docs/runbooks/zizmor-workflow-audits.md +0 -81
@@ -1,354 +0,0 @@
1
- #!/usr/bin/env python3
2
- """Generate Team Skills Platform Introduction PPTX"""
3
-
4
- from pptx import Presentation
5
- from pptx.util import Inches, Pt
6
- from pptx.enum.text import PP_ALIGN, MSO_ANCHOR
7
-
8
- def add_title_slide(prs, title, subtitle=""):
9
- slide_layout = prs.slide_layouts[6] # Blank
10
- slide = prs.slides.add_slide(slide_layout)
11
-
12
- # Title
13
- txBox = slide.shapes.add_textbox(Inches(0.5), Inches(3), Inches(9), Inches(1.5))
14
- tf = txBox.text_frame
15
- p = tf.paragraphs[0]
16
- p.text = title
17
- p.font.size = Pt(44)
18
- p.font.bold = True
19
- p.alignment = PP_ALIGN.CENTER
20
-
21
- # Subtitle
22
- if subtitle:
23
- txBox2 = slide.shapes.add_textbox(Inches(0.5), Inches(4.5), Inches(9), Inches(1))
24
- tf2 = txBox2.text_frame
25
- p2 = tf2.paragraphs[0]
26
- p2.text = subtitle
27
- p2.font.size = Pt(24)
28
- p2.alignment = PP_ALIGN.CENTER
29
-
30
- return slide
31
-
32
- def add_content_slide(prs, title, bullets):
33
- slide_layout = prs.slide_layouts[6] # Blank
34
- slide = prs.slides.add_slide(slide_layout)
35
-
36
- # Title
37
- txBox = slide.shapes.add_textbox(Inches(0.5), Inches(0.4), Inches(9), Inches(0.8))
38
- tf = txBox.text_frame
39
- p = tf.paragraphs[0]
40
- p.text = title
41
- p.font.size = Pt(32)
42
- p.font.bold = True
43
-
44
- # Content
45
- txBox2 = slide.shapes.add_textbox(Inches(0.5), Inches(1.5), Inches(9), Inches(5.5))
46
- tf2 = txBox2.text_frame
47
- tf2.word_wrap = True
48
-
49
- for i, bullet in enumerate(bullets):
50
- if i == 0:
51
- p = tf2.paragraphs[0]
52
- else:
53
- p = tf2.add_paragraph()
54
- p.text = f"• {bullet}"
55
- p.font.size = Pt(20)
56
- p.space_after = Pt(12)
57
-
58
- return slide
59
-
60
- def add_two_column_slide(prs, title, left_title, left_bullets, right_title, right_bullets):
61
- slide_layout = prs.slide_layouts[6]
62
- slide = prs.slides.add_slide(slide_layout)
63
-
64
- # Title
65
- txBox = slide.shapes.add_textbox(Inches(0.5), Inches(0.4), Inches(9), Inches(0.8))
66
- tf = txBox.text_frame
67
- p = tf.paragraphs[0]
68
- p.text = title
69
- p.font.size = Pt(32)
70
- p.font.bold = True
71
-
72
- # Left column title
73
- left_title_box = slide.shapes.add_textbox(Inches(0.5), Inches(1.3), Inches(4.3), Inches(0.5))
74
- lt = left_title_box.text_frame.paragraphs[0]
75
- lt.text = left_title
76
- lt.font.size = Pt(22)
77
- lt.font.bold = True
78
-
79
- # Left content
80
- left_box = slide.shapes.add_textbox(Inches(0.5), Inches(1.8), Inches(4.3), Inches(5))
81
- lt2 = left_box.text_frame
82
- lt2.word_wrap = True
83
- for i, b in enumerate(left_bullets):
84
- p = lt2.paragraphs[0] if i == 0 else lt2.add_paragraph()
85
- p.text = f"• {b}"
86
- p.font.size = Pt(16)
87
- p.space_after = Pt(8)
88
-
89
- # Right column title
90
- right_title_box = slide.shapes.add_textbox(Inches(5.2), Inches(1.3), Inches(4.3), Inches(0.5))
91
- rt = right_title_box.text_frame.paragraphs[0]
92
- rt.text = right_title
93
- rt.font.size = Pt(22)
94
- rt.font.bold = True
95
-
96
- # Right content
97
- right_box = slide.shapes.add_textbox(Inches(5.2), Inches(1.8), Inches(4.3), Inches(5))
98
- rt2 = right_box.text_frame
99
- rt2.word_wrap = True
100
- for i, b in enumerate(right_bullets):
101
- p = rt2.paragraphs[0] if i == 0 else rt2.add_paragraph()
102
- p.text = f"• {b}"
103
- p.font.size = Pt(16)
104
- p.space_after = Pt(8)
105
-
106
- return slide
107
-
108
- def main():
109
- prs = Presentation()
110
- prs.slide_width = Inches(10)
111
- prs.slide_height = Inches(7.5)
112
-
113
- # Slide 1: Cover
114
- add_title_slide(
115
- prs,
116
- "Team Skills Platform",
117
- "角色化研发团队协作平台介绍 | 2026-03-29"
118
- )
119
-
120
- # Slide 2: Problem Background
121
- add_content_slide(prs, "问题背景:现状痛点", [
122
- "单 Agent 能力局限:单个 AI 无法承担完整研发链路",
123
- "角色边界模糊:缺乏清晰的职责分工和交接契约",
124
- "工程规范碎片化:前端、API、安全、测试规范分散不统一",
125
- "平台绑定:规范定义无法同时适配 Codex 与 Claude 双平台",
126
- "技能传承困难:最佳实践依赖个人经验,难以系统化沉淀"
127
- ])
128
-
129
- # Slide 3: Solution
130
- add_content_slide(prs, "解决方案:核心思路", [
131
- "8 大角色矩阵:Tech Lead 统筹 + 7 个专业角色分工协作",
132
- "标准化交接契约:角色间交接有明确定义和 quality gates",
133
- "Canonical Source of Truth:roles/ 目录为单一真相源",
134
- "双平台自动生成:Codex 与 Claude 技能/Agent 自动导出",
135
- "ECC Harness Layer:27 个专家级 Specialist Agent 增强"
136
- ])
137
-
138
- # Slide 4: Architecture Overview
139
- add_two_column_slide(
140
- prs,
141
- "架构概览",
142
- "8 角色矩阵",
143
- [
144
- "tech-lead: 统一 intake、拆解、分派、冲突决策",
145
- "product-manager: 需求、PRD、用户故事、验收标准",
146
- "project-manager: 排期、依赖、里程碑、风险",
147
- "architect: ADR、接口契约、数据边界",
148
- "frontend-engineer: 前端实现与自测",
149
- "backend-engineer: 后端实现与自测",
150
- "qa-engineer: 测试计划、回归验证、放行建议",
151
- "devops-engineer: 发布、监控、回滚与运行保障"
152
- ],
153
- "ECC Harness Layer",
154
- [
155
- "27 个 Specialist Agents",
156
- "planner, architect, chief-of-staff",
157
- "security-reviewer (OWASP Top 10)",
158
- "build-error-resolver (8 语言版本)",
159
- "tdd-guide, loop-operator, harness-optimizer",
160
- "e2e-runner, refactor-cleaner",
161
- "语言专项审查 (Java/Go/Python/Rust...)"
162
- ]
163
- )
164
-
165
- # Slide 5: Engineering Results - Role System
166
- add_content_slide(prs, "工程化成果:角色与规范体系", [
167
- "roles/: 8 个角色的 canonical 定义(role.yaml)",
168
- "skills/roles/: 自动生成的角色技能(平台无关)",
169
- "agents/roles/: 自动生成的角色 Agent 提示词",
170
- "agents/specialists/: 27 个 ECC 专家级 Agent",
171
- "commands/: 团队命令表面(/team-intake, /team-plan, /handoff 等)",
172
- "rules/: 团队工作规则 + 语言规范包(TS/Java/Python/Go)"
173
- ])
174
-
175
- # Slide 6: Engineering Results - Frontend Governance
176
- add_two_column_slide(
177
- prs,
178
- "工程化成果:前端治理",
179
- "前端工程规范",
180
- [
181
- "frontend-engineering: React/Next 工程规范",
182
- "组件结构、状态管理、语义化",
183
- "可访问性(Accessibility)基线",
184
- "性能优化标准"
185
- ],
186
- "UI/UX 设计系统",
187
- [
188
- "frontend-ui-ux-system: 设计知识库",
189
- "产品类型、视觉方向、设计 Token",
190
- "交互模式、响应式设计",
191
- "前端质量门禁规则"
192
- ]
193
- )
194
-
195
- # Slide 7: Engineering Results - Security Gates
196
- add_content_slide(prs, "工程化成果:安全与质量门禁", [
197
- "CodeQL 安全扫描:PR 级别代码安全审查",
198
- "Secret 扫描:防止密钥/凭证泄露",
199
- "SBOM 生成:软件物料清单追溯",
200
- "SLSA 验证:供应链安全级别认证",
201
- "Contract Testing:API 契约测试",
202
- "Trivy/Checkov:容器与 IaC 安全扫描",
203
- "Security Reviewer:OWASP Top 10 全覆盖(30+ 检查项)"
204
- ])
205
-
206
- # Slide 8: Hooks System
207
- add_two_column_slide(
208
- prs,
209
- "工程化成果:Hooks 系统",
210
- "PreToolUse Hooks (5个)",
211
- [
212
- "tmux-reminder — dev server 建议用 tmux",
213
- "git-push-reminder — push 前检查变更",
214
- "console-log-warning — 检测调试语句",
215
- "doc-file-warning — 非标准文档警告",
216
- "mcp-health-check — MCP 健康检查"
217
- ],
218
- "PostToolUse Hooks (3个)",
219
- [
220
- "quality-gate — 质量检查(空格/分号)",
221
- "format-suggestion — JS/TS 格式化建议",
222
- "pr-created — PR URL 自动提取"
223
- ]
224
- )
225
-
226
- # Slide 9: Continuous Learning & Cost Awareness
227
- add_two_column_slide(
228
- prs,
229
- "工程化成果:持续学习 + 成本感知",
230
- "Continuous Learning v2.1",
231
- [
232
- "Instinct Store:项目级/全局级 instinct",
233
- "observe hook:工具调用观察捕获",
234
- "instinct_cli:list/evolve/export/import",
235
- "自动从会话提取最佳实践模式",
236
- "置信度评分(0.3-0.9)驱动演进"
237
- ],
238
- "Cost-Aware LLM Pipeline",
239
- [
240
- "Haiku:轻量任务($0.001/1K)",
241
- "Sonnet:主开发($0.01/1K)",
242
- "Opus:深度推理($0.05/1K)",
243
- "Context Budget:70%/85% 阈值预警",
244
- "cost_tracker:会话成本记录"
245
- ]
246
- )
247
-
248
- # Slide 10: Public Commands Expansion
249
- add_two_column_slide(
250
- prs,
251
- "工程化成果:公开命令面扩展",
252
- "主链 + specialist",
253
- [
254
- "/team-intake -> /team-plan -> /team-execute",
255
- "/handoff -> /team-review -> /team-release",
256
- "/plan、/code-review、/build-fix、/verify",
257
- "/multi-frontend、/multi-backend"
258
- ],
259
- "本轮新增重点",
260
- [
261
- "/tdd — 先锁测试与成功标准",
262
- "/harness-audit — 平台能力体检与缺口收敛",
263
- "specialist 结果必须回收到主链",
264
- "平台治理与业务交付路径分离"
265
- ]
266
- )
267
-
268
- # Slide 11: Runtime vs Explicit Commands
269
- add_two_column_slide(
270
- prs,
271
- "工程化成果:显式命令与 Runtime 分层",
272
- "显式命令",
273
- [
274
- "用户可见入口,负责触发决策与流程",
275
- "例:/team-plan、/tdd、/harness-audit",
276
- "适合解释主链、specialist 与角色协作",
277
- "对外演示时最容易理解"
278
- ],
279
- "Runtime 后台机制",
280
- [
281
- "memory persistence、observe、cost tracking",
282
- "context budget、compact/archive、instinct learning",
283
- "自动增强长会话稳定性与成本控制",
284
- "不是每次都手动执行的命令"
285
- ]
286
- )
287
-
288
- # Slide 12: Core Advantages
289
- add_content_slide(prs, "核心优势", [
290
- "Canonical Source of Truth:单一真相源,平台无关定义",
291
- "双平台支持:Codex 与 Claude 同步覆盖",
292
- "角色化协作:明确职责边界,标准化交接",
293
- "ECC 增强层:27 个专家级 Agent 快速编排",
294
- "Hooks 系统:8 个自动化质量门禁钩子",
295
- "持续学习:Instinct-based 自动模式提取",
296
- "120+ Runbooks:覆盖快速入门、使用场景、治理、故障排查",
297
- "可安装、可验证、可迁移:不是项目脚手架,而是能力基座"
298
- ])
299
-
300
- # Slide 13: Demo Materials
301
- add_content_slide(prs, "演示与汇报材料", [
302
- "业务主链演示:demo-scenario.md + demo-execution-log.md",
303
- "平台升级演示:platform-capability-demo-script.md + execution-log",
304
- "vertical 场景导览:vertical-scenario-route-map.md",
305
- "vertical 场景矩阵:vertical-scenario-capability-matrix.md",
306
- "已具备完整 demo 闭环的 9 类 vertical 场景可直接复用",
307
- "命令总表:command-and-capability-matrix.md",
308
- "runtime 总览:runtime-capabilities-overview.md",
309
- "对外讲解可直接配合 presentation-talk-track.md"
310
- ])
311
-
312
- # Slide 14: Vertical Demo Route Map
313
- add_two_column_slide(
314
- prs,
315
- "vertical Demo 成熟度",
316
- "已具备完整闭环",
317
- [
318
- "GitHub Actions / 供应链治理",
319
- "AI / Eval 平台",
320
- "移动端 / 小程序交付",
321
- "IaC / Kubernetes 平台仓库",
322
- "插件 / 扩展仓库",
323
- "数据 / ML pipeline 仓库",
324
- "安全 / 合规平台仓库",
325
- "内部开发者平台",
326
- "数据可观测性 / 质量平台"
327
- ],
328
- "推荐使用方式",
329
- [
330
- "onboarding:先看 route map,再用 matrix 查缺层",
331
- "汇报:直接复用各 vertical demo script",
332
- "复盘:搭配 execution log 做团队同步",
333
- "平台讲解:先讲 platform capability,再切到 vertical"
334
- ]
335
- )
336
-
337
- # Slide 15: Next Steps
338
- add_content_slide(prs, "下一步规划", [
339
- "平台接入:扩大团队试点范围",
340
- "规范完善:补充更多语言/框架规范包",
341
- "ECC 扩展:继续沉淀专家级技能",
342
- "度量体系:建立团队效能度量指标",
343
- "知识沉淀:持续丰富 Runbooks 库",
344
- "Eval 驱动开发:完善 pass@k 指标体系"
345
- ])
346
-
347
- # Save
348
- import os
349
- output_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "team-skills-platform-intro.pptx")
350
- prs.save(output_path)
351
- print(f"PPTX saved to: {output_path}")
352
-
353
- if __name__ == "__main__":
354
- main()
@@ -1,38 +0,0 @@
1
- # Implementation Onboarding Brief
2
-
3
- 这份讲稿面向准备把 Team Skills Platform 接入真实仓库的实施人。重点不是平台价值,而是怎么开始、用哪一套材料、如何避免入口选错。
4
-
5
- ## 1. 适用对象
6
-
7
- - Tech Lead
8
- - Architect
9
- - Project Manager
10
- - 负责仓库 onboarding 的实施人
11
-
12
- ## 2. 讲解重点
13
-
14
- ### 先讲从哪开始
15
-
16
- 建议讲法:
17
-
18
- “接入时不要先看所有 runbook,而是先决定项目属于哪种模板。先从 examples 索引选模板,再从 starter playbook 选起手句,再看 route map 和 capability matrix 判断当前 vertical 材料是否完整。”
19
-
20
- ### 再讲主链和 specialist 怎么配
21
-
22
- 建议讲法:
23
-
24
- “新仓库先跑 `/team-intake` 和 `/team-plan`,只有返工成本高或任务复杂时再插 `/tdd`、`/multi-*`、`/verify`。specialist 的结果必须回到 handoff 或主链。”
25
-
26
- ### 最后讲如何选 vertical 资产
27
-
28
- 建议讲法:
29
-
30
- “如果你要快速复用现成材料,不要只看模板,要先查 route map 和 capability matrix。前者告诉你讲解入口,后者告诉你某个 vertical 是否已经具备 walkthrough、demo script 和 execution log。”
31
-
32
- ## 3. 推荐顺序
33
-
34
- 1. [../../examples/INDEX.md](../../examples/INDEX.md)
35
- 2. [../../examples/project-type-starter-playbook.md](../../examples/project-type-starter-playbook.md)
36
- 3. [vertical-scenario-route-map.md](vertical-scenario-route-map.md)
37
- 4. [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
38
- 5. [../runbooks/project-onboarding.md](../runbooks/project-onboarding.md)
@@ -1,97 +0,0 @@
1
- # Presentation Talk Track
2
-
3
- 这份讲稿用于把 Team Skills Platform 当前能力快速讲清楚,适合对团队、管理层或新接入项目做口头说明。它和 runbook 的区别是:runbook 偏操作,这份讲稿偏讲解顺序与口径。
4
-
5
- 如果你已经明确当前听众是谁,不一定要直接用这一份通用稿。管理层优先看 [executive-briefing-talk-track.md](executive-briefing-talk-track.md),实施接入优先看 [implementation-onboarding-brief.md](implementation-onboarding-brief.md),培训场景优先看 [workshop-facilitator-guide.md](workshop-facilitator-guide.md)。如果还没决定怎么选,先看 [audience-presentation-route-map.md](audience-presentation-route-map.md)。
6
-
7
- ## 1. 5 分钟版本
8
-
9
- ### 第 1 分钟:先讲平台是什么
10
-
11
- 建议讲法:
12
-
13
- “这不是一个 prompts 仓库,也不是单个 Agent 的技能包,而是一套角色化研发团队协作平台。主链由 tech-lead 编排,8 个角色协作完成需求、方案、研发、测试和发布。”
14
-
15
- ### 第 2 分钟:讲现在新增了什么
16
-
17
- 建议讲法:
18
-
19
- “这轮升级不是只加了几个文档,而是扩了四层能力。第一层是公开命令,新增了 /tdd 和 /harness-audit;第二层是 ECC skills,包括 eval-harness、continuous-learning、cost-aware-llm-pipeline、strategic-compact;第三层是可选知识图谱能力 Graphify,用于 brownfield 结构扫描和依赖路径证据;第四层是 runtime,包括 memory、observe、budget、compact、instinct 等后台机制。”
20
-
21
- ### 第 3 分钟:讲两个关键新入口
22
-
23
- 建议讲法:
24
-
25
- “/tdd 用来先锁测试和成功标准,减少返工;/harness-audit 用来体检平台本身,找文档、命令、skills、hooks 的同步缺口。前者面向交付闭环,后者面向平台治理。”
26
-
27
- ### 第 4 分钟:讲 runtime 和显式命令的区别
28
-
29
- 建议讲法:
30
-
31
- “runtime 不是要你每次手动执行的命令,而是在后台帮助长会话稳定运行的机制,比如会话记忆、行为观察、成本记录、上下文压缩和 instinct 学习。显式命令负责决策入口,runtime 负责增强执行环境。”
32
-
33
- ### 第 5 分钟:讲现在该看哪些材料
34
-
35
- 建议讲法:
36
-
37
- “如果你要上手,就先看 quick start;如果你要讲平台,就看命令与能力矩阵、runtime 总览和新的平台能力演示剧本;如果你要做 brownfield 结构认知,先跑 Graphify preflight 再看 Graphify runbook;如果你要讲具体业务场景,现在已经有 9 条完整 vertical 闭环,可以从 route map 和 capability matrix 里直接选。”
38
-
39
- ## 2. 15 分钟版本
40
-
41
- ### 第一段:平台结构
42
-
43
- - 讲 8 角色矩阵
44
- - 讲主链 `/team-*`
45
- - 讲 specialist 与 main chain 的关系
46
-
47
- ### 第二段:能力升级
48
-
49
- - 讲 `/tdd`
50
- - 讲 `/harness-audit`
51
- - 讲新增 ECC skills
52
- - 讲 runtime 与 hooks
53
-
54
- ### 第三段:材料与落地
55
-
56
- - 讲 quick start、usage scenarios、role runbooks 已经同步
57
- - 讲新 demo 材料如何使用
58
- - 讲 route map 和 markdown matrix 如何帮助选择 9 条 vertical 闭环入口
59
- - 讲 `node scripts/validate-library.js` 仍然通过,说明升级没有破坏基线
60
-
61
- ## 3. 演示时建议打开的材料
62
-
63
- - `team-skills-platform-intro.pptx`(运行 generate_ppt.py 生成)
64
- - `agent-capability-matrix.pptx`(运行 generate_capability_matrix.py 生成)
65
- - [audience-presentation-route-map.md](audience-presentation-route-map.md)
66
- - [../runbooks/command-and-capability-matrix.md](../runbooks/command-and-capability-matrix.md)
67
- - [../runbooks/runtime-capabilities-overview.md](../runbooks/runtime-capabilities-overview.md)
68
- - [../runbooks/platform-capability-demo-script.md](../runbooks/platform-capability-demo-script.md)
69
- - [../runbooks/graphify-knowledge-graph-usage.md](../runbooks/graphify-knowledge-graph-usage.md)
70
- - [vertical-scenario-route-map.md](vertical-scenario-route-map.md)
71
- - [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
72
-
73
- ## 4. 常见问答口径
74
-
75
- - 问:/tdd 是不是只适合代码开发
76
- 答:不是,它更本质的作用是先定义完成标准和验证口径。
77
-
78
- - 问:/harness-audit 能不能替代 review
79
- 答:不能,它针对平台治理,不针对业务放行。
80
-
81
- - 问:runtime 能力是不是都要手动调用
82
- 答:不是,runtime 是后台机制,显式命令才是入口。
83
-
84
- - 问:Graphify 会不会替代 `/team-*` 主链
85
- 答:不会,Graphify 只是可选证据层能力,结论必须回落到 `/team-plan`、`/team-execute`、`/team-review`。
86
-
87
- - 问:为什么保留旧 demo 又新增新 demo
88
- 答:旧 demo 讲业务主链,新 demo 讲平台能力升级,两者服务的目标不同。
89
-
90
- ## 5. 讲完后建议发出的链接
91
-
92
- - [README.md](README.md)
93
- - [audience-presentation-route-map.md](audience-presentation-route-map.md)
94
- - [../runbooks/team-skills-usage.md](../runbooks/team-skills-usage.md)
95
- - [../runbooks/platform-capability-demo-execution-log.md](../runbooks/platform-capability-demo-execution-log.md)
96
- - [vertical-scenario-route-map.md](vertical-scenario-route-map.md)
97
- - [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
@@ -1,99 +0,0 @@
1
- # Vertical Scenario Route Map
2
-
3
- 这份导览页回答两个问题:现在有哪些 vertical 场景已经有完整演示闭环,哪些还处在“模板 + 起手句 + 连续脚本”阶段,以及 presentation / onboarding 应该先带用户看哪一层。
4
-
5
- ## 1. 使用方式
6
-
7
- - 如果你在做 onboarding,先看“按成熟度选择”
8
- - 如果你在做汇报或演示,先看“按讲解目标选择”
9
- - 如果你在补仓库文档,先看“按材料层次选择”
10
-
11
- ## 2. 按成熟度选择
12
-
13
- ### 已具备完整 demo 闭环
14
-
15
- 这些场景已经具备模板、起手句 / 连续脚本、walkthrough、demo script、execution log:
16
-
17
- - GitHub Actions / 供应链治理
18
- - AI / Eval 平台
19
- - 移动端 / 小程序交付
20
- - IaC / Kubernetes 平台仓库
21
- - 插件 / 扩展仓库
22
- - 数据 / ML pipeline 仓库
23
- - 安全 / 合规平台仓库
24
- - 内部开发者平台
25
- - 数据可观测性 / 质量平台
26
-
27
- 推荐入口:
28
-
29
- - [../runbooks/github-actions-supply-chain-demo-script.md](../runbooks/github-actions-supply-chain-demo-script.md)
30
- - [../runbooks/ai-eval-platform-demo-script.md](../runbooks/ai-eval-platform-demo-script.md)
31
- - [../runbooks/mobile-miniapp-demo-script.md](../runbooks/mobile-miniapp-demo-script.md)
32
- - [../runbooks/iac-kubernetes-platform-demo-script.md](../runbooks/iac-kubernetes-platform-demo-script.md)
33
- - [../runbooks/plugin-extension-platform-demo-script.md](../runbooks/plugin-extension-platform-demo-script.md)
34
- - [../runbooks/data-ml-pipeline-demo-script.md](../runbooks/data-ml-pipeline-demo-script.md)
35
- - [../runbooks/security-compliance-platform-demo-script.md](../runbooks/security-compliance-platform-demo-script.md)
36
- - [../runbooks/internal-developer-platform-demo-script.md](../runbooks/internal-developer-platform-demo-script.md)
37
- - [../runbooks/data-observability-quality-demo-script.md](../runbooks/data-observability-quality-demo-script.md)
38
-
39
- ## 3. 按讲解目标选择
40
-
41
- ### 目标:讲平台能力升级
42
-
43
- - 先看 [../runbooks/platform-capability-demo-script.md](../runbooks/platform-capability-demo-script.md)
44
- - 再看 [../runbooks/platform-capability-demo-execution-log.md](../runbooks/platform-capability-demo-execution-log.md)
45
-
46
- ### 目标:讲 brownfield 结构扫描与知识图谱证据
47
-
48
- - 先看 [../runbooks/graphify-knowledge-graph-usage.md](../runbooks/graphify-knowledge-graph-usage.md)
49
- - 再结合 [../runbooks/project-onboarding.md](../runbooks/project-onboarding.md) 的接入判定
50
- - 再回到 [../runbooks/command-and-capability-matrix.md](../runbooks/command-and-capability-matrix.md) 的推荐组合链路
51
-
52
- ### 目标:讲一个具体 vertical 如何跑通
53
-
54
- - 供应链治理:看 [../runbooks/github-actions-supply-chain-demo-script.md](../runbooks/github-actions-supply-chain-demo-script.md)
55
- - AI / Eval:看 [../runbooks/ai-eval-platform-demo-script.md](../runbooks/ai-eval-platform-demo-script.md)
56
- - 移动端:看 [../runbooks/mobile-miniapp-demo-script.md](../runbooks/mobile-miniapp-demo-script.md)
57
- - IaC / Kubernetes:看 [../runbooks/iac-kubernetes-platform-demo-script.md](../runbooks/iac-kubernetes-platform-demo-script.md)
58
- - 插件 / 扩展:看 [../runbooks/plugin-extension-platform-demo-script.md](../runbooks/plugin-extension-platform-demo-script.md)
59
- - 数据 / ML pipeline:看 [../runbooks/data-ml-pipeline-demo-script.md](../runbooks/data-ml-pipeline-demo-script.md)
60
- - 安全 / 合规:看 [../runbooks/security-compliance-platform-demo-script.md](../runbooks/security-compliance-platform-demo-script.md)
61
- - 内部开发者平台:看 [../runbooks/internal-developer-platform-demo-script.md](../runbooks/internal-developer-platform-demo-script.md)
62
- - 数据可观测性 / 质量平台:看 [../runbooks/data-observability-quality-demo-script.md](../runbooks/data-observability-quality-demo-script.md)
63
-
64
- ### 目标:讲“新接入项目该从哪个模板开始”
65
-
66
- - 先看 [../../examples/INDEX.md](../../examples/INDEX.md)
67
- - 再看 [../../examples/project-type-starter-playbook.md](../../examples/project-type-starter-playbook.md)
68
-
69
- ## 4. 按材料层次选择
70
-
71
- ### 只想找项目模板
72
-
73
- - 看 [../../examples/INDEX.md](../../examples/INDEX.md)
74
-
75
- ### 想直接复制第一句话
76
-
77
- - 看 [../../examples/project-type-starter-playbook.md](../../examples/project-type-starter-playbook.md)
78
-
79
- ### 想直接复制一段连续脚本
80
-
81
- - 看 [../../examples/vertical-project-conversation-scripts.md](../../examples/vertical-project-conversation-scripts.md)
82
-
83
- ### 想照着讲一场演示
84
-
85
- - 看 [../runbooks/platform-capability-demo-script.md](../runbooks/platform-capability-demo-script.md)
86
- - 或任一 vertical demo script,再结合 [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md) 选路径
87
-
88
- ### 想拿复盘 / 同步材料
89
-
90
- - 看各类 execution log
91
-
92
- ## 5. Onboarding 建议顺序
93
-
94
- 1. 先用 [../../examples/INDEX.md](../../examples/INDEX.md) 选项目类型
95
- 2. 再用 [../../examples/project-type-starter-playbook.md](../../examples/project-type-starter-playbook.md) 复制起手句
96
- 3. 如果场景已具备完整 demo 闭环,再直接复用对应 demo script
97
- 4. 如果要先确认材料是否完整,再查 [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
98
- 5. 如果只是选项目模板,再回到 quick start 和 onboarding 路径接入
99
- 6. 如果项目是 brownfield 且结构复杂,先执行 Graphify 预检查与结构扫描,再进入 `/team-plan`
@@ -1,47 +0,0 @@
1
- # Workshop Facilitator Guide
2
-
3
- 这份讲稿面向内部培训和团队赋能。重点不是单次汇报,而是如何带一场 30 到 90 分钟的培训,让团队真正理解主链、specialist 和 vertical 材料怎么配合。
4
-
5
- ## 1. 30 分钟版
6
-
7
- ### 第一段:平台结构
8
-
9
- - 讲 8 角色矩阵
10
- - 讲 `/team-*` 主链
11
- - 讲 handoff 为什么是事实收口点
12
-
13
- ### 第二段:能力升级
14
-
15
- - 讲 `/tdd`
16
- - 讲 `/harness-audit`
17
- - 讲 runtime 与显式命令分层
18
-
19
- ### 第三段:怎么选材料
20
-
21
- - 讲 examples 索引
22
- - 讲 route map
23
- - 讲 capability matrix
24
-
25
- ## 2. 60 分钟版
26
-
27
- ### 加强内容
28
-
29
- - 加一段 vertical 选择演示
30
- - 加一段 Claude / Codex 起手对比
31
- - 加一段 specialist 结果回收到 handoff 的示例
32
-
33
- ## 3. 90 分钟版
34
-
35
- ### 加强内容
36
-
37
- - 选一个完整 vertical 做 walkthrough
38
- - 选一个非完整听众路线,演示如何从 audience route map 反推讲法
39
- - 补一段 QA / DevOps 如何接 review / release
40
-
41
- ## 4. 推荐打开的材料
42
-
43
- - [presentation-talk-track.md](presentation-talk-track.md)
44
- - [audience-presentation-route-map.md](audience-presentation-route-map.md)
45
- - [../runbooks/command-and-capability-matrix.md](../runbooks/command-and-capability-matrix.md)
46
- - [../runbooks/runtime-capabilities-overview.md](../runbooks/runtime-capabilities-overview.md)
47
- - [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)