@colin4k1024/tsp 2.4.0 → 2.4.2

package/docs/plans/llm-surface-reduction-execution-history.md

@@ -0,0 +1,124 @@
+# LLM Surface Reduction Execution History
+
+本文只记录执行历史，不再重复审计结论。
+> 历史命令说明：文中出现的 `python3 scripts/build_platform_artifacts.py` 与 `python3 scripts/validate_library.py` 为当时执行命名；当前等价命令分别为 `node scripts/build-platform-artifacts.js` 与 `node scripts/validate-library.js`。
+
+审计结论看 [llm-surface-reduction-audit.md](llm-surface-reduction-audit.md)，执行清单看 [llm-surface-reduction-execution-checklist.md](llm-surface-reduction-execution-checklist.md)。
+
+## 1. 最终结果
+
+- 2026-03-29 已完成第一阶段执行。
+- 2026-03-29 已完成第二阶段的第一批执行。
+- 2026-03-29 已完成第二阶段的第二批执行。
+- 2026-03-29 已完成第二阶段的第三批与尾批执行。
+- 2026-03-29 已完成第三阶段模板减法执行。
+- 2026-03-29 已完成第四阶段剩余边界项收敛执行。
+
+## 2. 各阶段摘要
+
+### 2.1 第一阶段：先减命名噪音
+
+已完成：
+
+- 删除 `skills/search-first`
+- 删除 `skills/requirements-analysis`
+- 删除 `skills/feature-backlog`
+- 删除 `skills/incident-response`
+- 删除 `/eval`
+- 删除 `/sessions`
+- 收敛 `/orchestrate`、`/multi-workflow`、`/multi-execute`
+- 收敛 `/multi-plan` 到 `/plan`
+
+### 2.2 第二阶段：合并薄 skill 和薄命令
+
+已完成：
+
+- 合并 `skills/solution-design`
+- 合并 `skills/release-readiness`
+- 合并 `skills/coding-standards`
+- 合并 `skills/verification-loop`
+- 合并 `skills/frontend-patterns`
+- 合并 `skills/backend-patterns`
+- 合并 `skills/api-design`
+- 合并 `skills/deployment-patterns`
+- 合并 `skills/tdd-workflow`
+- 合并 `skills/security-review`
+- 合并 `/test-coverage` 到 `/tdd`
+- 将 `/update-docs` 下沉为 specialist 能力
+
+### 2.3 第三阶段：模板减法
+
+已完成：
+
+- 删除 `templates/prd.md`
+- 删除 `templates/delivery-plan.md`
+- 删除 `templates/test-plan.md`
+- 删除 `templates/incident-brief.md`
+- 删除 `templates/adr.md`
+- 将最小字段与治理要求回写到 `rules/artifact-standards.md` 与相关 runbook
+
+### 2.4 第四阶段：边界项收敛
+
+已完成：
+
+- 删除 `skills/test-strategy`
+- 将测试口径收敛回 `qa-engineer`、`artifact-standards.md` 与测试相关 runbook
+
+## 3. 实际删除清单
+
+### 3.1 Shared skills
+
+- `requirements-analysis`
+- `feature-backlog`
+- `incident-response`
+- `release-readiness`
+- `solution-design`
+- `test-strategy`
+
+### 3.2 ECC skills
+
+- `search-first`
+- `verification-loop`
+- `coding-standards`
+- `frontend-patterns`
+- `backend-patterns`
+- `security-review`
+- `api-design`
+- `deployment-patterns`
+- `tdd-workflow`
+
+### 3.3 公开命令
+
+- `/eval`
+- `/sessions`
+- `/multi-plan`
+- `/multi-execute`
+- `/multi-workflow`
+- `/orchestrate`
+- `/test-coverage`
+- `/update-docs`
+
+### 3.4 模板
+
+- `templates/prd.md`
+- `templates/delivery-plan.md`
+- `templates/test-plan.md`
+- `templates/incident-brief.md`
+- `templates/adr.md`
+
+## 4. 执行闭环
+
+每一批执行后都已完成以下动作：
+
+- 清理角色、生成器、README、runbook、examples 和 usage scenarios 中的引用
+- 运行历史命令 `python3 scripts/build_platform_artifacts.py`（当前等价：`node scripts/build-platform-artifacts.js`）
+- 运行历史命令 `python3 scripts/validate_library.py`（当前等价：`node scripts/validate-library.js`）
+
+最新校验结果：
+
+- Roles: 8
+- Shared skills: 3
+- ECC skills: 9
+- Company skills: 8
+- Specialist agents: 27
+- Generated artifacts: 69

package/docs/plans/team-skills-platform-migration.md

@@ -0,0 +1,54 @@
+---
+version: "0.1.0"
+status: draft
+created: 2026-03-27
+updated: 2026-03-27
+owner: 工程团队
+doc_tier: historical
+last_verified: 2026-04-17
+source_of_truth:
+  - ../../CHANGELOG.md
+  - ../../README.md
+---
+
+# Team Skills 平台迁移方案
+
+> 历史快照（非现行操作手册）：本页用于归档迁移期设计，不作为当前构建/校验命令的权威来源。
+
+## 1. 迁移目标
+
+- 从旧的三段式流程技能迁移到“`Tech Lead` 编排 + 专业角色协作”的团队模型。
+- 统一 Codex / Claude 的角色入口、命令面、规则和模板。
+- 保留历史能力用于追溯，但不再作为活跃入口暴露。
+
+## 2. 能力重组
+
+| 历史能力类型 | 新归属 |
+|-------------|--------|
+| 文档与方案编排 | `product-manager` + `architect` + `tech-lead` |
+| backlog / 计划拆解 | `product-manager` + `project-manager` + `tech-lead` |
+| 实施闭环 | `frontend-engineer` / `backend-engineer` / `qa-engineer` / `devops-engineer` + `tech-lead` |
+
+## 3. 迁移步骤
+
+1. 建立 canonical source：`roles/`、`skills/`、`rules/`、`templates/`
+2. 建立生成脚本：历史命名 `build_platform_artifacts.py`（当前等价：`node scripts/build-platform-artifacts.js`）
+3. 生成角色 skills、agent prompt、commands、插件清单
+4. 更新入口文档：`README.md`、`AGENTS.md`、`CLAUDE.md`
+5. 清理历史业务细节内容，只保留平台资产，并把不再适合作为正式 skill 的资料降级到 runbook / toolkit / profile
+6. 增加 validate / install 脚本并执行回归校验
+
+## 4. 切换规则
+
+- 新需求一律从 `tech-lead` 或明确的角色入口开始。
+- 仓库只保留平台资产，不保留历史业务代码与业务文档内容。
+- 活跃安装索引只面向新的 Team Skills 平台。
+- 设计态资料、脚本型资料和公司样式资料优先以 runbook / toolkit / profile 方式承接，不再默认包装成正式 custom overlay。
+
+## 5. 验收标准
+
+- 8 个角色都具备 `role.yaml + role skill + agent prompt`
+- `commands/` 中存在 6 个标准命令
+- 历史命名 `scripts/validate_library.py` 通过（当前等价：`node scripts/validate-library.js`）
+- Codex / Claude 安装脚本能把产物同步到目标目录
+- 新入口文档不再把旧模型当作活跃推荐路径

package/docs/presentation/README.md

@@ -0,0 +1,42 @@
+# Presentation Materials
+
+这组材料用于向团队、管理层或新接入项目说明 Team Skills Platform 当前能力，不参与平台生成链路，但属于正式可交付辅助资产。
+
+## 1. 文件说明
+
+- [generate_ppt.py](generate_ppt.py)：生成平台总览 PPTX 的脚本。
+- [generate_capability_matrix.py](generate_capability_matrix.py)：生成能力矩阵 PPTX 的脚本。
+- [presentation-talk-track.md](presentation-talk-track.md)：5 分钟 / 15 分钟口头讲解提词稿。
+- [audience-presentation-route-map.md](audience-presentation-route-map.md)：按听众选择演示路线的导览页。
+- [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)：面向团队培训的讲解稿。
+- [vertical-scenario-route-map.md](vertical-scenario-route-map.md)：vertical 场景的模板 / 脚本 / demo 成熟度导览页。
+- [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)：markdown 版 vertical 场景材料覆盖矩阵。
+
+## 2. 适合什么时候看
+
+- 想快速向团队解释“这不是普通 prompts 仓库，而是角色化协作平台”时。
+- 想说明 memory persistence、error experience、parallel execution 这类新增能力时。
+- 想做 onboarding、方案汇报或阶段性成果同步时。
+- 想先按 9 个完整 vertical 闭环选一条最适合当前听众的演示路线时。
+- 想按听众而不是按材料名选择讲法时。
+
+## 3. 推荐搭配阅读
+
+- 平台总说明：[../../README.md](../../README.md)
+- 运行时能力说明：[../runbooks/ecc-harness-usage.md](../runbooks/ecc-harness-usage.md)
+- 命令与能力矩阵：[../runbooks/command-and-capability-matrix.md](../runbooks/command-and-capability-matrix.md)
+- runtime 总览：[../runbooks/runtime-capabilities-overview.md](../runbooks/runtime-capabilities-overview.md)
+- 错误经验库：[../runbooks/error-experience-usage.md](../runbooks/error-experience-usage.md)
+- 并行执行框架：[../runbooks/parallel-execution-usage.md](../runbooks/parallel-execution-usage.md)
+- 完整演示记录：[../runbooks/demo-execution-log.md](../runbooks/demo-execution-log.md)
+- 平台能力升级演示剧本：[../runbooks/platform-capability-demo-script.md](../runbooks/platform-capability-demo-script.md)
+- 平台能力升级执行记录：[../runbooks/platform-capability-demo-execution-log.md](../runbooks/platform-capability-demo-execution-log.md)
+- 口头讲解提词稿：[presentation-talk-track.md](presentation-talk-track.md)
+- 按听众的讲解路线：[audience-presentation-route-map.md](audience-presentation-route-map.md)
+- 管理层讲解稿：[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)
+- vertical 场景导览：[vertical-scenario-route-map.md](vertical-scenario-route-map.md)
+- vertical 场景矩阵：[../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)

package/docs/presentation/audience-presentation-route-map.md

@@ -0,0 +1,84 @@
+# Audience Presentation Route Map
+
+这份导览页回答一个问题：面对不同听众，Team Skills Platform 现有材料该怎么组合，不需要每次从头拼讲法。
+
+## 1. 使用方式
+
+- 如果听众是管理层，先看“管理层路线”
+- 如果听众是准备接入项目的 Tech Lead / Architect，先看“实施接入路线”
+- 如果听众是团队培训或内部赋能，先看“培训路线”
+
+## 2. 管理层路线
+
+### 适合谁
+
+- 管理层
+- 平台赞助人
+- 需要快速判断平台价值与落地面的负责人
+
+### 推荐目标
+
+- 解释平台不是 prompts 仓库，而是角色化协作平台
+- 解释公开命令、runtime 与 9 条 vertical 闭环的业务价值
+- 解释当前能力已经可用于 onboarding、治理与演示
+
+### 推荐顺序
+
+1. [executive-briefing-talk-track.md](executive-briefing-talk-track.md)
+2. `team-skills-platform-intro.pptx`（运行 generate_ppt.py 生成）
+3. `agent-capability-matrix.pptx`（运行 generate_capability_matrix.py 生成）
+4. [vertical-scenario-route-map.md](vertical-scenario-route-map.md)
+5. 如果需要 runbook 层的一页材料，继续看 [../runbooks/executive-value-one-page.md](../runbooks/executive-value-one-page.md)
+
+## 3. 实施接入路线
+
+### 适合谁
+
+- Tech Lead
+- Architect
+- Project Manager
+- 负责把平台接入新仓库的实施人
+
+### 推荐目标
+
+- 明确该从哪个模板起手
+- 明确主链、specialist 与 handoff 怎么接
+- 明确 vertical 材料能否直接复用到当前项目
+
+### 推荐顺序
+
+1. [implementation-onboarding-brief.md](implementation-onboarding-brief.md)
+2. [../../examples/INDEX.md](../../examples/INDEX.md)
+3. [../../examples/project-type-starter-playbook.md](../../examples/project-type-starter-playbook.md)
+4. [vertical-scenario-route-map.md](vertical-scenario-route-map.md)
+5. [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
+6. 如果要按实施步骤继续读，转到 [../runbooks/implementation-onboarding-reading-path.md](../runbooks/implementation-onboarding-reading-path.md)
+
+## 4. 培训路线
+
+### 适合谁
+
+- 研发团队
+- QA / DevOps / PM / Architect 联合培训
+- 新成员入组培训
+
+### 推荐目标
+
+- 理解主链和 specialist 的边界
+- 理解 runtime 与显式命令的区别
+- 理解不同 vertical 场景该如何选材料和复用 demo
+
+### 推荐顺序
+
+1. [workshop-facilitator-guide.md](workshop-facilitator-guide.md)
+2. [presentation-talk-track.md](presentation-talk-track.md)
+3. [../runbooks/command-and-capability-matrix.md](../runbooks/command-and-capability-matrix.md)
+4. [../runbooks/runtime-capabilities-overview.md](../runbooks/runtime-capabilities-overview.md)
+5. [../runbooks/vertical-scenario-capability-matrix.md](../runbooks/vertical-scenario-capability-matrix.md)
+6. 如果要按培训节奏展开，转到 [../runbooks/team-training-reading-path.md](../runbooks/team-training-reading-path.md)
+
+## 5. 一页判断
+
+- 只想讲价值和成果：走管理层路线
+- 只想让项目开始接入：走实施接入路线
+- 只想让团队理解如何日常使用：走培训路线

package/docs/presentation/executive-briefing-talk-track.md

@@ -0,0 +1,50 @@
+# Executive Briefing Talk Track
+
+这份讲稿面向管理层、平台赞助人或需要快速理解平台价值的人。重点不是命令细节，而是为什么这个平台值得继续推广。
+
+## 1. 3 分钟版本
+
+### 第 1 分钟：平台定位
+
+建议讲法：
+
+“Team Skills Platform 不是 prompts 仓库，也不是单个 Agent 技能集合，而是一套把需求、方案、研发、测试、发布串成角色化协作链路的平台。”
+
+### 第 2 分钟：本轮升级重点
+
+建议讲法：
+
+“这一轮升级做了三件真正影响落地的事。第一，公开命令面更完整，`/tdd` 和 `/harness-audit` 让交付闭环和平台治理都能标准化；第二，runtime 具备 memory、observe、budget、compact 等增强能力，长会话可控；第三，已经形成 9 条完整 vertical 演示闭环，平台不再只停留在通用模板。”
+
+### 第 3 分钟：管理价值
+
+建议讲法：
+
+“对管理层来说，最重要的不是某个命令，而是这套平台把角色边界、交接质量和材料复用都沉淀下来了。它能缩短项目接入成本，也能降低平台能力升级后的说明成本。”
+
+## 2. 8 分钟版本
+
+### 第一段：为什么不是普通 AI 配置仓库
+
+- 讲 8 角色矩阵
+- 讲主链和 handoff
+- 讲 specialist 只是加速器，不是平行责任链
+
+### 第二段：为什么现在比之前更可用
+
+- 讲 `/tdd` 和 `/harness-audit`
+- 讲 runtime 增强
+- 讲 9 条 vertical 闭环
+
+### 第三段：为什么适合继续推广
+
+- 讲 onboarding 材料已成体系
+- 讲 vertical 演示已可按听众选路由
+- 讲仓库校验仍然通过，没有破坏基线
+
+## 3. 建议打开的材料
+
+- `team-skills-platform-intro.pptx`（运行 generate_ppt.py 生成）
+- `agent-capability-matrix.pptx`（运行 generate_capability_matrix.py 生成）
+- [audience-presentation-route-map.md](audience-presentation-route-map.md)
+- [vertical-scenario-route-map.md](vertical-scenario-route-map.md)