@colin4k1024/tsp 2.4.1 → 2.4.2

package/docs/runbooks/team-plan-example.md

@@ -0,0 +1,62 @@
+---
+version: "0.1.0"
+status: draft
+created: 2026-03-28
+updated: 2026-03-28
+owner: 工程团队
+---
+
+# Team Plan 完整示例
+
+本文对标 [team-command-output-contracts.md](team-command-output-contracts.md) 和 [../../commands/team-plan.md](../../commands/team-plan.md)，给出可直接参考的完整 plan 输出示例。
+
+## 1. 场景
+
+延续 [team-intake-example.md](team-intake-example.md) 的导出需求。
+
+## 2. 输入示例
+
+```text
+/team-plan
+基于导出能力 intake 结果，拆解角色职责、风险、依赖与技能装配。
+```
+
+## 3. 完整输出示例
+
+```text
+交付计划
+- 阶段 1：锁定导出接口契约与权限策略
+- 阶段 2：前后端并行实现与自测
+- 阶段 3：联调、验证与发布准备
+
+角色分工
+- product-manager：补齐导出字段范围和验收标准
+- architect：确认权限边界与接口契约
+- backend-engineer：实现导出接口与权限判断
+- frontend-engineer：实现导出按钮、状态和错误提示
+- qa-engineer：设计权限组合与导出内容验证用例
+
+风险与依赖清单
+- 风险：权限规则不清会拖慢接口设计
+- 风险：导出字段可能涉及敏感数据
+- 依赖：私有权限中心 是否启用需在本阶段锁定
+
+是否需要 ADR
+- 本次不需要完整 ADR，但需保留权限策略决策记录
+
+技能装配清单
+- shared：不单独挂载方案 skill，方案决策直接回落到 architect / tech-lead 主链
+- ecc：verification，按场景启用，触发原因是联调和验收，主责角色 qa-engineer
+- enterprise：私有权限中心，按场景启用，触发原因是导出权限边界，主责角色 architect
+
+前端交付物与检查点
+- 导出按钮交互说明
+- loading / 成功 / 失败态
+- 桌面端和 iPad 横屏验证证据
+```
+
+## 4. 常见错误
+
+- 只有任务拆分，没有依赖和风险
+- custom overlay启用结果没写清楚
+- 前端检查点没有进入计划输出

package/docs/runbooks/team-release-example.md

@@ -0,0 +1,63 @@
+---
+version: "0.1.0"
+status: draft
+created: 2026-03-28
+updated: 2026-03-28
+owner: 工程团队
+---
+
+# Team Release 完整示例
+
+本文对标 [team-command-output-contracts.md](team-command-output-contracts.md) 和 [../../commands/team-release.md](../../commands/team-release.md)，给出发布方案和放行结论的完整示例。
+
+## 1. 场景
+
+- 导出能力已开发完成并通过 QA
+- 本次准备灰度发布
+- 需要明确观察窗口、回滚条件和责任链
+
+## 2. 输入示例
+
+```text
+/team-release
+基于当前测试放行结果，整理导出能力的灰度发布方案、回滚条件和观察项。
+```
+
+## 3. 完整输出示例
+
+```text
+发布方案
+- 范围：审批列表导出能力、权限判断调整、前端导出按钮
+- 方式：先 staging 验证，再 10% 灰度，观察 30 分钟后决定是否全量
+
+上线检查结果
+- 测试放行：通过
+- 环境检查：通过
+- 前端 smoke：关键页面可访问，导出按钮状态正常
+
+放行结论与后续观察项
+- 结论：有条件放行
+- 观察项：导出成功率、接口错误率、前端点击后反馈时延
+
+回滚与监控动作
+- 回滚条件：错误率超过阈值，或导出结果字段异常
+- 回滚步骤：关闭导出入口开关，回滚后端权限配置
+- 责任人：devops-engineer、backend-engineer
+
+企业内控补充信息
+- 是否企业内部应用：是
+- 数据风险：导出字段已按当前权限规则控制
+
+可选领域扩展执行记录
+- 扩展能力：GitLab 手动流水线补充手册
+- 触发条件：本次灰度需人工观察窗口
+- 执行摘要：按发布 runbook 执行 staging 与灰度步骤
+```
+
+## 4. 常见错误
+
+- 只写发布步骤，不写回滚和观察项
+- 放行结论没有条件说明
+- custom overlay 或 runbook 扩展记录没有回落到 release 输出
+
+发布前、中、后的快速参考可继续看：[pre-release-checklist.md](pre-release-checklist.md)、[canary-decision-matrix.md](canary-decision-matrix.md)、[post-rollback-verification-checklist.md](post-rollback-verification-checklist.md)

package/docs/runbooks/team-review-example.md

@@ -0,0 +1,61 @@
+---
+version: "0.1.0"
+status: draft
+created: 2026-03-28
+updated: 2026-03-28
+owner: 工程团队
+---
+
+# Team Review 完整示例
+
+本文对标 [team-command-output-contracts.md](team-command-output-contracts.md) 和 [../../commands/team-review.md](../../commands/team-review.md)，给出评审结论、阻塞项和放行建议的完整示例。
+
+## 1. 场景
+
+- QA 已完成导出能力验证
+- 需要输出统一评审结论，判断是否可进入发布准备
+
+## 2. 输入示例
+
+```text
+/team-review
+基于当前导出能力的实现说明、自测结果和 QA 验证结果，输出评审结论、阻塞项和放行建议。
+```
+
+## 3. 完整输出示例
+
+```text
+评审结论
+- 当前版本功能完整，权限主路径和导出结果正确性通过验证
+- 允许进入灰度发布准备，但需带观察项
+
+阻塞项
+- 无阻塞项
+
+放行建议
+- 建议：有条件通过
+- 条件：灰度阶段需重点观察导出成功率与错误率
+
+前端质量门禁检查结果
+- 视觉一致性：通过
+- 交互完整性：通过
+- 边界态：通过
+- 无障碍与性能：通过
+
+领域扩展约束核对结果
+- 能力名：私有权限中心 权限映射能力
+- 关键约束：按钮展示与接口权限判断必须一致
+- 证据：权限用例验证、页面行为验证、接口响应验证
+- 状态：通过
+- 残余风险：大数据量导出性能仍需在灰度阶段继续观察
+
+残余风险与后续动作
+- 风险：导出量大时的性能波动
+- 动作：DevOps 在灰度阶段观察接口耗时和错误率
+```
+
+## 4. 常见错误
+
+- 把所有问题都写成阻塞项，无法判断是否可放行
+- 没有把前端质量门禁和领域约束分开
+- 放行建议没有附带条件和观察项

package/docs/runbooks/team-skills-test-run.md

@@ -0,0 +1,184 @@
+# Audit Report
+
+- Audit Root: 
+
+## Summary
+
+- Event Count: 8
+
+### Components
+
+| Component | Count |
+| --- | ---: |
+| tool | 8 |
+
+### Actions
+
+| Action | Count |
+| --- | ---: |
+| team_intake | 2 |
+| team_plan | 2 |
+| team_execute | 2 |
+| team_review | 2 |
+
+### Statuses
+
+| Status | Count |
+| --- | ---: |
+| started | 4 |
+| success | 4 |
+
+### Phases
+
+| Phase | Count |
+| --- | ---: |
+| pre | 4 |
+| post | 4 |
+
+## Tail
+
+```json
+[
+  {
+    "timestamp": "2026-03-30T10:11:12.449054",
+    "phase": "pre",
+    "component": "tool",
+    "action": "team_intake",
+    "status": "started",
+    "call_id": "50319a58524145328c1f450ff5aa30d3",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "tech-lead",
+    "payload": {
+      "requirement": "为本平台添加 tests/test_platform_smoke.py，验证平台安装产物关键路径（roles/skills/commands/规则/marketplace）均存在",
+      "priority": "high",
+      "roles_involved": [
+        "tech-lead",
+        "backend-engineer",
+        "qa-engineer"
+      ],
+      "constraints": "仅新增文件；不修改现有代码；pytest 必须全部通过",
+      "ui_involved": false
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.449494",
+    "phase": "post",
+    "component": "tool",
+    "action": "team_intake",
+    "status": "success",
+    "call_id": "50319a58524145328c1f450ff5aa30d3",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "tech-lead",
+    "payload": {
+      "output": "intake-complete",
+      "participants": [
+        "tech-lead",
+        "backend-engineer",
+        "qa-engineer"
+      ],
+      "scope": "新增 1 个测试文件；覆盖 roles/specialists/commands/skills/rules/marketplace",
+      "success_criteria": "pytest 通过；审计日志可查"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.449629",
+    "phase": "pre",
+    "component": "tool",
+    "action": "team_plan",
+    "status": "started",
+    "call_id": "7d052f7914bc42aaadf6e8adc89a2288",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "tech-lead",
+    "payload": {
+      "based_on": "intake-complete"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.449713",
+    "phase": "post",
+    "component": "tool",
+    "action": "team_plan",
+    "status": "success",
+    "call_id": "7d052f7914bc42aaadf6e8adc89a2288",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "tech-lead",
+    "payload": {
+      "tasks": [
+        "T1: backend-engineer 编写 tests/test_platform_smoke.py",
+        "T2: qa-engineer 运行 pytest 并记录结论",
+        "T3: tech-lead 验证审计日志并标记 done"
+      ],
+      "skill_pack": [
+        "validate_library",
+        "audit_logger"
+      ],
+      "risks": "无；仅新增文件",
+      "handoff_to": "backend-engineer"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.449807",
+    "phase": "pre",
+    "component": "tool",
+    "action": "team_execute",
+    "status": "started",
+    "call_id": "a038518ee0224379900b344d2b12ae0e",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "backend-engineer",
+    "payload": {
+      "task": "create tests/test_platform_smoke.py"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.450054",
+    "phase": "post",
+    "component": "tool",
+    "action": "team_execute",
+    "status": "success",
+    "call_id": "a038518ee0224379900b344d2b12ae0e",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "backend-engineer",
+    "payload": {
+      "file_created": "tests/test_platform_smoke.py",
+      "lines": 111,
+      "test_cases": "8 roles + 6 specialists + 11 commands + 5 role-skills + 2 plugin/marketplace + 4 rules"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:12.450178",
+    "phase": "pre",
+    "component": "tool",
+    "action": "team_review",
+    "status": "started",
+    "call_id": "e72c93cb5a284b81a9144f2722f09635",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "qa-engineer",
+    "payload": {
+      "test_file": "tests/test_platform_smoke.py"
+    }
+  },
+  {
+    "timestamp": "2026-03-30T10:11:13.106389",
+    "phase": "post",
+    "component": "tool",
+    "action": "team_review",
+    "status": "success",
+    "call_id": "e72c93cb5a284b81a9144f2722f09635",
+    "session_id": "md-smoke",
+    "project_path": "/path/to/your/project",
+    "source": "qa-engineer",
+    "payload": {
+      "pytest_exit_code": 0,
+      "verdict": "pass",
+      "output_tail": "handoff-contract.md] PASSED [ 94%]\ntests/test_platform_smoke.py::test_rule_file_installed[artifact-standards.md] PASSED [ 97%]\ntests/test_platform_smoke.py::test_rule_file_installed[escalation-policy.md] PASSED [100%]\n\n============================== 36 passed in 0.03s ==============================\n"
+    }
+  }
+]
+```