@scemoon/cdh 1.0.0

package/ai-dlc-skill/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: ai-dlc-skill
+description: |
+  AI-Driven Development Lifecycle for monorepo multi-component stacks.
+  Adaptive orchestration: Master Agent evaluates complexity, delegates sub-tasks.
+allowed_tools:
+  - read
+  - grep
+  - glob
+  - bash
+  - edit
+  - write
+  - webfetch
+  - websearch
+  - task
+  - skill
+triggers:
+  - ai-dlc
+  - ai dlc
+compatibility:
+  cdh: ">=1.4"
+  opencode: ">=1.15"
+  claude-code: ">=1.0"
+  openai-codex: ">=1.0"
+  cursor: ">=0.45"
+license: Apache-2.0
+metadata:
+  version: "4.0.0"
+  stack_topology: monorepo
+  fr_namespaces: [NATIVE, DESKTOP, WEB, BE, WXA, MYA, TTA, INT]
+---
+
+# AI-DLC Master Orchestrator
+
+## Core Cycle
+
+```
+① Understand (SDD+BDD)   Intent → Spec Delta → BDD Feature Files
+② Plan (SDD+TDD)         Design Doc → Task DAG → Test Plan
+③ Verify (BDD+TDD)       Red → Green → Refactor per scenario
+④ Deliver (SDD+Cloud)    Stack Preview → e2e → Production + BVT
+```
+
+## Components
+
+| Prefix | Component | Directory | FR Namespace |
+|--------|-----------|-----------|--------------|
+| NATIVE | Mobile | `apps/native/` | `NATIVE-FR-NNN` |
+| DESKTOP | Desktop | `apps/desktop/` | `DESKTOP-FR-NNN` |
+| WEB | Browser | `apps/web/` | `WEB-FR-NNN` |
+| BE | Service | `apps/backend/` | `BE-FR-NNN` |
+| WXA | WeChat Mini | `apps/wxa/` | `WXA-FR-NNN` |
+| MYA | Alipay Mini | `apps/mya/` | `MYA-FR-NNN` |
+| TTA | TikTok Mini | `apps/tta/` | `TTA-FR-NNN` |
+| INT | Contracts | `contracts/`, `packages/shared/` | `INT-FR-NNN` |
+
+## Adaptive Flow
+
+See `core/adaptive-flow.md` for complexity assessment.
+
+1. Analyze intent → determine complexity (L1-L5)
+2. Select phases to execute
+3. Delegate each phase via `Task(agent_type="general", prompt=...)` using the phase's `prompt.md`
+4. Collect results, enforce gates, iterate or advance
+
+## Phase Reference
+
+| Phase | Lifecycle | Rules | Practices |
+|-------|-----------|-------|-----------|
+| ① Understand | `phases/understand/lifecycle.md` | `phases/understand/rules.md` | SDD, BDD |
+| ② Plan | `phases/plan/lifecycle.md` | `phases/plan/rules.md` | SDD, TDD |
+| ③ Verify | `phases/verify/lifecycle.md` | `phases/verify/rules.md` | BDD, TDD |
+| ④ Deliver | `phases/deliver/lifecycle.md` | `phases/deliver/rules.md` | SDD, Cloud |
+
+Security baseline: `core/security.md` (all phases).

package/ai-dlc-skill/agents/deliver-agent.md

@@ -0,0 +1,24 @@
+# Deliver Agent 指令
+
+你是一个 AI-DLC Deliver Phase Agent。
+由 Master Agent 委派处理部署交付。
+
+## 入口
+
+`phases/deliver/prompt.md` — 完整的委派 prompt 模板。
+`phases/deliver/lifecycle.md` — 阶段流程说明。
+`phases/deliver/rules.md` — DLV-001 到 DLV-004 + STK-001 到 STK-006 规则。
+
+## 关键产出
+
+1. Stack Preview → `deploy_stack --preview`
+2. Per-component e2e + Cross-stack e2e
+3. Staging smoke test
+4. Production deploy + BVT
+5. Stack rollback（BVT 失败时）
+
+## 约束
+
+- 遵守 `core/security.md`
+- Production deploy 必须等待 Human Approval
+- BVT 失败自动触发 stack rollback

package/ai-dlc-skill/agents/master.md

@@ -0,0 +1,44 @@
+# Master Agent 指令
+
+你是 AI-DLC Master Orchestrator Agent。
+
+## 职责
+
+1. **分析意图**：读取用户输入，判断复杂度级别 L1-L5
+2. **选择阶段**：根据复杂度选择需执行的 phase 序列
+3. **委派执行**：对每个 phase 使用 `Task(agent_type="general", prompt="...")` 委派给子 Agent
+4. **收集结果**：检查每个 phase 的 Gate 是否通过
+5. **Human Gate**：关键决策点（breaking change、production deploy）暂停等待用户确认
+
+## 复杂度判断
+
+见 `core/adaptive-flow.md`。
+
+## 委派模式
+
+```python
+# 示例：委派 Understand Phase
+Task(
+    agent_type="general",
+    prompt=f"""
+    你是一个 Understand Phase Agent。
+    请完成以下任务：
+    1. 读取 phases/understand/prompt.md 获取完整指令
+    2. 对 {intent_desc} 执行需求分析
+    3. 遵守 phases/understand/rules.md 中的规则
+    """
+)
+```
+
+## Phase 执行参考
+
+| Phase | Prompt | Rules |
+|-------|--------|-------|
+| Understand | `phases/understand/prompt.md` | `phases/understand/rules.md` |
+| Plan | `phases/plan/prompt.md` | `phases/plan/rules.md` |
+| Verify | `phases/verify/prompt.md` | `phases/verify/rules.md` |
+| Deliver | `phases/deliver/prompt.md` | `phases/deliver/rules.md` |
+
+## 安全基线
+
+始终遵守 `core/security.md`。

package/ai-dlc-skill/agents/plan-agent.md

@@ -0,0 +1,23 @@
+# Plan Agent 指令
+
+你是一个 AI-DLC Plan Phase Agent。
+由 Master Agent 委派处理方案设计。
+
+## 入口
+
+`phases/plan/prompt.md` — 完整的委派 prompt 模板。
+`phases/plan/lifecycle.md` — 阶段流程说明。
+`phases/plan/rules.md` — PLN-001 到 PLN-004 规则。
+
+## 关键产出
+
+1. Design Doc → `openspec/changes/{id}/design.md`
+2. Task DAG → `openspec/changes/{id}/task-list.md`
+3. Test Plan → embedded in task-list
+4. Contract Plan → `contract-diff.md` 占位
+
+## 约束
+
+- 遵守 `core/security.md`
+- 遵守 STK-001, STK-002
+- 完成前必须通过 Human Gate

package/ai-dlc-skill/agents/understand-agent.md

@@ -0,0 +1,23 @@
+# Understand Agent 指令
+
+你是一个 AI-DLC Understand Phase Agent。
+由 Master Agent 委派处理需求分析。
+
+## 入口
+
+`phases/understand/prompt.md` — 完整的委派 prompt 模板。
+`phases/understand/lifecycle.md` — 阶段流程说明。
+`phases/understand/rules.md` — UND-001 到 UND-006 规则。
+
+## 关键产出
+
+1. Intent 捕获 → `requirements.md`
+2. Spec Delta (EARS) → `openspec/changes/{id}/spec-delta.md`
+3. BDD Feature 文件 → `apps/{component}/features/`
+4. 跨组件 Feature 文件 → `features/cross-stack/`（如适用）
+5. 合约文件 → `contracts/{api,events}/`（跨组件时）
+
+## 约束
+
+- 遵守 `core/security.md`
+- 完成前必须通过 Human Gate

package/ai-dlc-skill/agents/verify-agent.md

@@ -0,0 +1,27 @@
+# Verify Agent 指令
+
+你是一个 AI-DLC Verify Phase Agent。
+由 Master Agent 委派处理测试验证。
+
+## 入口
+
+`phases/verify/prompt.md` — 完整的委派 prompt 模板。
+`phases/verify/lifecycle.md` — 阶段流程说明。
+`phases/verify/rules.md` — VRF-001 到 VRF-006 + INT-001 到 INT-006 规则。
+
+## 关键产出
+
+1. TDD 测试代码 → `apps/{component}/tests/`
+2. TDD 实现代码 → `apps/{component}/src/`
+3. BDD step defs → `apps/{component}/features/steps/`
+4. 合约测试 → `tests/contract/`
+5. 跨组件 e2e → `tests/cross-stack/`
+6. Contract Diff → `openspec/changes/{id}/contract-diff.md`
+
+## 质量门禁
+
+- coverage ≥ 80%
+- BDD scenarios 100% pass
+- 0 vulns, no TODO
+- Contract backward-compat
+- Cross-stack e2e 100% pass

package/ai-dlc-skill/architecture/project-structure.md

@@ -0,0 +1,78 @@
+# 项目工程目录架构
+
+## 顶层布局
+
+```
+{{project_root}}/
+├── apps/
+│   ├── native/          # NATIVE-FR-*   Mobile (Flutter/Dart)
+│   ├── desktop/         # DESKTOP-FR-*  Desktop (Electron/TypeScript)
+│   ├── web/             # WEB-FR-*      Browser (Next.js/TypeScript)
+│   ├── backend/         # BE-FR-*       Service (Python / Node / Go)
+│   ├── wxa/             # WXA-FR-*      WeChat Mini Program (Vant Weapp/JavaScript)
+│   ├── mya/             # MYA-FR-*      Alipay Mini Program (Ant Design Mini/JavaScript)
+│   └── tta/             # TTA-FR-*      TikTok Mini Program (TypeScript)
+├── contracts/           # INT-FR-*      OpenAPI / AsyncAPI / Runtime Contract
+│   ├── api/
+│   ├── events/
+│   └── functions/
+├── packages/shared/     # INT-FR-*      从 contracts 生成的共享类型
+├── features/            # BDD feature 文件
+│   └── cross-stack/     # 跨组件集成场景
+├── tests/
+│   ├── contract/        # 合约测试 (INT-FR 级别, provider-agnostic)
+│   └── cross-stack/     # 跨组件 e2e 测试 (对 STACK_URL 运行)
+├── openspec/            # AI-DLC 生命周期产出物
+│   └── changes/{id}/
+│       ├── spec-delta.md
+│       ├── design.md
+│       ├── task-list.md
+│       ├── contract-diff.md
+│       └── walkthrough.md
+├── providers/           # 云平台部署配置
+│   ├── tcb/
+│   └── aliyun/
+├── tools/               # 脚手架脚本
+│   ├── generate_shared.py
+│   └── contract_diff.py
+├── .opencode/           # OpenCode 配置
+│   └── skills/ai-dlc-skill/
+├── .cdh/                # CDHA 项目状态
+│   ├── config.yaml
+│   ├── state.json
+│   └── SKILL.md
+└── AI-DLC-CONTEXT.md    # Brownfield 上下文摘要 (自动生成)
+```
+
+## 组件内部结构 (标准模板)
+
+```
+apps/{component}/
+├── src/              # 实现代码
+│   └── {module}/
+├── tests/
+│   ├── unit/         # TDD 单元测试
+│   ├── integration/  # 集成测试 (含 DB)
+│   └── e2e/          # E2E 测试 (对 preview URL)
+├── features/         # BDD feature 文件
+│   └── steps/        # BDD step definitions
+├── contracts/        # 组件级合约引用
+├── .skill/           # 组件级 Skill (自动生成)
+│   └── SKILL.md
+├── package.json
+└── ...
+```
+
+## FR 命名空间 ↔ 目录映射
+
+| FR 前缀 | 目录 | 测试目录 | e2e target |
+|---------|------|---------|------------|
+| NATIVE-FR-NNN | `apps/native/src/` | `apps/native/tests/` | BACKEND_URL |
+| DESKTOP-FR-NNN | `apps/desktop/src/` | `apps/desktop/tests/` | BACKEND_URL |
+| WEB-FR-NNN | `apps/web/src/` | `apps/web/tests/` | WEB_URL + BACKEND_URL |
+| BE-FR-NNN | `apps/backend/src/` | `apps/backend/tests/` | BACKEND_URL |
+| WXA-FR-NNN | `apps/wxa/` | `apps/wxa/tests/` | BACKEND_URL |
+| MYA-FR-NNN | `apps/mya/` | `apps/mya/tests/` | BACKEND_URL |
+| TTA-FR-NNN | `apps/tta/` | `apps/tta/tests/` | BACKEND_URL |
+| INT-FR-NNN | `contracts/` + `packages/shared/` | `tests/contract/` | generated types |
+| 跨组件 | `features/cross-stack/` | `tests/cross-stack/` | STACK_URL |

package/ai-dlc-skill/brownfield/README.md

@@ -0,0 +1,30 @@
+# Brownfield 存量项目支持
+
+为已有项目自动生成语义上下文，辅助 AI Agent 理解代码库。
+
+## 使用方式
+
+```bash
+# 一键生成 AI-DLC-CONTEXT.md
+./brownfield/generate-context.sh
+
+# 单独步骤
+./brownfield/scripts/discover.sh       # 组件发现
+./brownfield/scripts/extract-api.sh    # API 表面提取
+./brownfield/scripts/deps.sh           # 跨组件依赖图
+```
+
+## 产出
+
+`AI-DLC-CONTEXT.md` 文件包含：
+1. 发现的组件列表 + 技术栈
+2. API 端点摘要
+3. 跨组件依赖 Mermaid 图
+4. 架构速览
+
+## 在 Phase 中的应用
+
+Master Agent 在 `affects` 声明后自动触发 Brownfield Phase：
+```
+L2+ 且有存量代码 → Task(agent_type="explore", prompt="...brownfield/scripts/...")
+```

package/ai-dlc-skill/brownfield/generate-context.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# generate-context.sh — Generate AI-DLC-CONTEXT.md for brownfield projects
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+OUTPUT="$PROJECT_ROOT/AI-DLC-CONTEXT.md"
+
+echo "# AI-DLC Context — $(basename "$PROJECT_ROOT")"
+echo ""
+echo "Auto-generated on $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+echo ""
+
+# 1. Component discovery
+echo "## Components"
+echo ""
+for comp_dir in "$PROJECT_ROOT"/apps/*/; do
+  name="$(basename "$comp_dir")"
+  pkg="$comp_dir/package.json"
+  if [ -f "$pkg" ]; then
+    framework="$(python3 -c "import json; d=json.load(open('$pkg')); print(d.get('framework','?'))" 2>/dev/null || echo "?")"
+    echo "- **$name**: $framework"
+  else
+    echo "- **$name**: (no package.json)"
+  fi
+done
+echo ""
+
+# 2. API surface
+echo "## API Surface"
+echo ""
+if [ -d "$PROJECT_ROOT/contracts/api" ]; then
+  find "$PROJECT_ROOT/contracts/api" -name "*.yaml" -o -name "*.yml" | while read -r f; do
+    echo "- $(basename "$f")"
+  done
+else
+  echo "(No contract files discovered)"
+fi
+echo ""
+
+# 3. Dependency map (simplified)
+echo "## Dependency Map"
+echo ""
+echo '```mermaid'
+echo 'graph LR'
+for comp_dir in "$PROJECT_ROOT"/apps/*/; do
+  name="$(basename "$comp_dir")"
+  pkg="$comp_dir/package.json"
+  if [ -f "$pkg" ]; then
+    python3 -c "
+import json
+d=json.load(open('$pkg'))
+for dep in d.get('dependencies',{}):
+    print(f'  {name} -->|depends| {dep}')
+for dep in d.get('devDependencies',{}):
+    pass
+" 2>/dev/null || true
+  fi
+done
+echo '```'
+echo ""
+
+echo "---"
+echo "Generated by brownfield/generate-context.sh"

package/ai-dlc-skill/brownfield/scripts/deps.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# deps.sh — Cross-component dependency graph generator
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+
+echo '```mermaid'
+echo 'graph LR'
+
+for comp_dir in "$PROJECT_ROOT"/apps/*/; do
+  name=$(basename "$comp_dir")
+  pkg="$comp_dir/package.json"
+
+  if [ -f "$pkg" ]; then
+    # Internal cross-component dependencies via workspace references
+    python3 -c "
+import json
+d = json.load(open('$pkg'))
+for dep_type in ['dependencies', 'devDependencies']:
+    for dep in d.get(dep_type, {}):
+        if dep.startswith('@') or dep.startswith('packages/'):
+            print(f'  {name} -->|depends| {dep}')
+" 2>/dev/null || true
+  fi
+done
+
+echo '```'

package/ai-dlc-skill/brownfield/scripts/discover.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# discover.sh — Component discovery for brownfield projects
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+
+echo "{
+  \"components\": ["
+
+first=true
+for comp_dir in "$PROJECT_ROOT"/apps/*/; do
+  name=$(basename "$comp_dir")
+  pkg="$comp_dir/package.json"
+  $first || echo ","
+  first=false
+
+  if [ -f "$pkg" ]; then
+    python3 -c "
+import json
+d=json.load(open('$pkg'))
+print(json.dumps({
+    'id': '$name',
+    'path': '$comp_dir',
+    'name': d.get('name', '$name'),
+    'framework': d.get('framework', '?'),
+    'language': d.get('language', '?'),
+}, indent=2))
+" 2>/dev/null || echo "{\"id\": \"$name\", \"path\": \"$comp_dir\"}"
+  else
+    echo "{\"id\": \"$name\", \"path\": \"$comp_dir\", \"warning\": \"no package.json\"}"
+  fi
+done
+
+echo "]}"

package/ai-dlc-skill/brownfield/scripts/extract-api.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# extract-api.sh — Extract API surface from contracts/ directory
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+
+echo "# API Surface"
+echo ""
+
+if [ ! -d "$PROJECT_ROOT/contracts" ]; then
+  echo "(No contracts/ directory found)"
+  exit 0
+fi
+
+# OpenAPI
+for f in "$PROJECT_ROOT"/contracts/api/*.yaml "$PROJECT_ROOT"/contracts/api/*.yml; do
+  [ -f "$f" ] || continue
+  echo "## File: $(basename "$f")"
+  python3 -c "
+import yaml, json
+d = yaml.safe_load(open('$f'))
+if 'paths' in d:
+    for path, methods in d['paths'].items():
+        for method, spec in methods.items():
+            print(f\"  {method.upper()} {path} — {spec.get('summary', '?')}\")
+if 'info' in d:
+    print(f\"  Title: {d['info'].get('title', '?')}\")
+    print(f\"  Version: {d['info'].get('version', '?')}\")
+" 2>/dev/null || echo "  (parse error)"
+  echo ""
+done
+
+# AsyncAPI
+for f in "$PROJECT_ROOT"/contracts/events/*.yaml "$PROJECT_ROOT"/contracts/events/*.yml; do
+  [ -f "$f" ] || continue
+  echo "## File: $(basename "$f")"
+  python3 -c "
+import yaml
+d = yaml.safe_load(open('$f'))
+channels = d.get('channels', {})
+for name, ch in channels.items():
+    print(f\"  Channel: {name}\")
+" 2>/dev/null || echo "  (parse error)"
+  echo ""
+done

package/ai-dlc-skill/components/backend.md

@@ -0,0 +1,34 @@
+# Backend 组件开发指南 (BE-FR-*)
+
+## 技术栈
+- 语言: Python / Node.js / Go
+- 框架: FastAPI / Express / Gin
+- 构建: poetry / pnpm / go build
+- 测试: pytest / vitest / go test
+- BDD: pytest-bdd
+
+## 关键命令
+- 构建: `pnpm --filter backend build`
+- 测试全部: `pnpm --filter backend test`
+- BDD: `pytest-bdd apps/backend/features/`
+- Lint: `pnpm --filter backend lint`
+- DB 迁移: `tcb db migrate` / `rds migrate`
+
+## 目录约定
+- `src/` → 组件源码（按模块组织）
+- `tests/unit/` → 单元测试
+- `tests/integration/` → 集成测试（含 DB）
+- `tests/e2e/` → E2E 测试（对 preview URL）
+- `features/` → BDD feature 文件
+- `features/steps/` → BDD step definitions
+
+## FR 命名空间
+- Prefix: BE-FR-NNN
+- 范围: 服务端/API 行为
+
+## 特定约束
+- 后端组件是 Stack 部署的入口点（先部署再暴露 BACKEND_URL）
+- API 合约定义在 `contracts/api/`（OpenAPI 3.1）
+- 依赖注入使用 provider pattern
+- 所有输入必须验证（SEC-002）
+- DB 查询必须使用参数化语句（SEC-003）

package/ai-dlc-skill/components/desktop.md

@@ -0,0 +1,30 @@
+# Desktop 组件开发指南 (DESKTOP-FR-*)
+
+## 技术栈
+- 框架: Electron / Tauri
+- 语言: TypeScript (Electron) / Rust + TS (Tauri)
+- 构建: `pnpm build:desktop`
+- 测试: Vitest / Jest
+- BDD: Spectron / WebDriverIO
+
+## 关键命令
+- 构建: `pnpm --filter desktop build`
+- 测试全部: `pnpm --filter desktop test`
+- BDD: `spectron test`
+- Lint: `pnpm --filter desktop lint`
+
+## 目录约定
+- `src/` → 组件源码
+- `tests/unit/` → 单元测试
+- `tests/e2e/` → E2E 测试
+- `features/` → BDD feature 文件
+- `features/steps/` → BDD step definitions
+
+## FR 命名空间
+- Prefix: DESKTOP-FR-NNN
+- 范围: 桌面端行为（macOS + Windows + Linux）
+
+## 特定约束
+- Desktop 组件依赖 `BACKEND_URL` 在构建时注入
+- 支持离线模式（本地优先）
+- 自动更新通过内置更新器

package/ai-dlc-skill/components/mya.md

@@ -0,0 +1,29 @@
+# MYA 组件开发指南 (MYA-FR-*) — 支付宝小程序
+
+## 技术栈
+- 框架: 支付宝原生小程序 / uni-app
+- 语言: JavaScript / TypeScript
+- 构建: 支付宝开发者工具
+- 测试: Jest
+- BDD: 手动 + miniprogram-automator
+
+## 关键命令
+- 构建: `pnpm --filter mya build`
+- 测试: `pnpm --filter mya test`
+- 预览: 上传到支付宝小程序预览平台
+- Lint: `pnpm --filter mya lint`
+
+## 目录约定
+- `src/` → 组件源码
+- `tests/unit/` → 单元测试
+- `features/` → BDD feature 文件
+
+## FR 命名空间
+- Prefix: MYA-FR-NNN
+- 范围: 支付宝小程序行为
+
+## 特定约束
+- 支付宝小程序有独立的审核流程
+- 预览通过小程序预览 QR 码访问
+- `BACKEND_URL` 在构建时注入
+- 支付功能使用支付宝小程序支付 SDK

package/ai-dlc-skill/components/native.md

@@ -0,0 +1,30 @@
+# Native 组件开发指南 (NATIVE-FR-*)
+
+## 技术栈
+- 框架: React Native / Flutter
+- 语言: TypeScript (React Native) / Dart (Flutter)
+- 构建: `pnpm build:native`
+- 测试: Jest (RN) / flutter_test (Flutter)
+- BDD: Detox / Maestro
+
+## 关键命令
+- 构建: `pnpm --filter native build`
+- 测试全部: `pnpm --filter native test`
+- BDD: `detox test` / `maestro test`
+- Lint: `pnpm --filter native lint`
+
+## 目录约定
+- `src/` → 组件源码
+- `tests/unit/` → 单元测试
+- `tests/e2e/` → E2E 测试
+- `features/` → BDD feature 文件
+- `features/steps/` → BDD step definitions
+
+## FR 命名空间
+- Prefix: NATIVE-FR-NNN
+- 范围: 原生移动端行为（iOS + Android）
+
+## 特定约束
+- Native 组件依赖 `BACKEND_URL` 在构建时注入
+- E2E 测试在真机或模拟器中运行
+- 不包含平台特定 UI 逻辑（web 端）

package/ai-dlc-skill/components/tta.md

@@ -0,0 +1,29 @@
+# TTA 组件开发指南 (TTA-FR-*) — 抖音小程序
+
+## 技术栈
+- 框架: 抖音原生小程序 / uni-app
+- 语言: JavaScript / TypeScript
+- 构建: 抖音开发者工具
+- 测试: Jest
+- BDD: 手动 + miniprogram-automator
+
+## 关键命令
+- 构建: `pnpm --filter tta build`
+- 测试: `pnpm --filter tta test`
+- 预览: 上传到抖音小程序预览平台
+- Lint: `pnpm --filter tta lint`
+
+## 目录约定
+- `src/` → 组件源码
+- `tests/unit/` → 单元测试
+- `features/` → BDD feature 文件
+
+## FR 命名空间
+- Prefix: TTA-FR-NNN
+- 范围: 抖音小程序行为
+
+## 特定约束
+- 抖音小程序审核流程
+- 预览通过小程序预览 QR 码访问
+- `BACKEND_URL` 在构建时注入
+- 视频/直播相关功能使用抖音小程序 API