TCB Harness

Full-lifecycle development harness for CloudBase (Tencent CloudBase) projects.

Platform Types

This harness manages three platform configurations:

Activation Contract

Read this first when

• Starting a new CloudBase project (MP / Web / Hybrid)
• Needing structured spec → design → code → test → deploy workflow
• Working on test design (case gen, data gen, evaluation, reports)
• Managing multiple projects with isolation

Then route to

• CloudBase MCP integration → cloudbase skill (CloudBase-specific tools, database, cloud functions, auth)
• Claude Code → claude-code-cli-openclaw skill (TDD coding sessions)
• Mini Program specific → references/miniprogram-guide.md (TDesign Miniprogram)
• Web specific → references/web-guide.md (TDesign React)
• Mobile specific → references/mobile-guide.md (TDesign Mobile React)
• Backend specific → references/backend-guide.md
• Knowledge Base → references/knowledge-base.md (含后台项目必读)

Do NOT use for

• Non-CloudBase projects (use platform-specific skills instead)
• Simple one-off code generation without lifecycle management

Project Directory Convention

projects/{project-name}/
├── .harness/
│   ├── config.json              # 项目配置（平台类型、envId、appid）
│   ├── state.json               # 当前阶段、进度、阻塞项
│   └── deploy-history.json      # 部署历史
├── specs/{spec-name}/
│   ├── requirements.md          # 需求文档
│   ├── design.md                # 技术方案
│   ├── tasks.md                 # 任务分解
│   └── reviews/                 # 评审记录
├── design/
│   ├── ui/                      # UI 设计（全平台通用）
│   │   ├── design-system.md
│   │   ├── color-palette.md
│   │   └── wireframes/
│   ├── frontend/                 # 前端设计（按平台隔离）
│   │   ├── miniprogram/         # 小程序前端设计（可选）
│   │   │   ├── architecture.md
│   │   │   ├── routing.md
│   │   │   ├── component-tree.md
│   │   │   └── subpackage.md
│   │   └── web/                 # Web 前端设计（可选）
│   │       ├── architecture.md
│   │       ├── routing.md
│   │       └── state-management.md
│   ├── backend/                  # 后台设计（可选，无后台时跳过）
│   │   ├── api-contract.md       # API 契约
│   │   ├── data-model.md         # 数据模型
│   │   ├── cloud-functions.md    # 云函数清单
│   │   └── security-rules.md     # 安全规则
│   └── shared/                   # 跨平台共享设计（可选）
│       └── common-types.md       # 共享类型定义
├── src/                          # 源码
│   ├── miniprogram/              # 小程序源码（可选）
│   │   ├── app.js / app.ts
│   │   ├── app.json
│   │   ├── pages/
│   │   ├── components/
│   │   ├── services/
│   │   └── utils/
│   └── web/                      # Web 源码（TDesign React，可选）
│       ├── index.html
│       ├── src/
│       └── dist/
├── cloud/                        # CloudBase 云函数（共享）
│   ├── {function-name}/
│   └── ...
├── tests/
│   ├── unit/
│   ├── integration/
│   ├── e2e/
│   ├── test-data/
│   └── reports/
└── docs/

平台决定规则：

• config.json 中 platform 字段决定哪些目录生效
• Hybrid 项目：frontend 下同时存在 miniprogram/、web/ 和 mobile/ 中的任意组合
• 无后台项目：backend/ 目录不存在，设计阶段跳过

Core Workflow

init → spec → design → coding(TDD) → testing → deploy → iterate
  ↑                                                    │
  └───────────── feedback loop ──────────────────────────┘

Phase Routing

Design Phase — Platform Routing

Design 阶段根据项目类型路由到不同参考文档：

全部项目必读

• references/ui-design-guide.md — UI 设计系统、配色、交互模式

按需读取

Hybrid 特殊规则

当项目同时包含小程序和 Web 时：

1. 设计产物按平台分别存放（frontend/miniprogram/ 和 frontend/web/）
2. 跨平台共享的类型/API 存入 design/shared/
3. 后台统一设计，两端共用
4. Coding 阶段可并行开发两端，或按优先级顺序开发

Deploy Phase — Detailed Config Output

Deploy 阶段必须产出完整的部署配置，详见 references/deploy-guide.md。核心原则：

• 小程序 — 通过 miniprogram-ci 构建/预览/上传
• Web — 通过 CloudBase 静态托管部署
• 后台 — 通过 CloudBase MCP 部署云函数/云托管
• 混合项目 — 统一 deploy-config.json 描述所有组件的部署状态

部署配置模板见 assets/templates/deploy/deploy-config.json.tpl，必须填入：

• 每个云函数的版本、超时、环境变量
• 每个云托管服务的镜像版本、实例规格
• 数据库集合的初始化状态
• 安全规则的最终配置
• 订阅消息模板 ID 映射

Phase Gate Summary

Integration with Other Skills

规则： 调用 CloudBase MCP 工具前必须先读 cloudbase skill。CloudBase Activation Contract 优先于本 skill。

Resource Index

scripts/

references/

assets/templates/