@scemoon/cdh 1.0.8 → 1.0.9-beta.1

package/ai-dlc-skill/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: ai-dlc-skill
+description: |
+  AI-Driven Development Lifecycle for monorepo multi-component stacks.
+  Core phases: Understand (SDD+BDD), Plan (SDD+TDD), Verify (BDD+TDD),
+  Deliver (SDD+Cloud). Adaptive orchestration: Master Agent evaluates
+  complexity, delegates sub-tasks.
+triggers:
+  - ai-dlc
+  - lifecycle
+  - BDD
+  - INT-FR
+  - spec-delta
+  - EARS
+  - feature-file
+  - task-list
+  - deploy-stack
+  - brownfield
+  - explore
+  - debug
+  - tcb-debug
+  - tcb-logs
+  - 排查日志
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+  - TodoClear
+  - TodoWrite
+  - Task
+  - AskUser
+phases:
+  - understand
+  - plan
+  - verify
+  - deliver
+  - brownfield
+  - debug
+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
+
+```
+0 Brownfield (optional)  Explore existing codebase → Context summary
+① 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
+⑤ Debug (optional)       TCB/云函数日志排查 → 问题定位
+```
+
+## 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 | `aidlc/contracts/`, `aidlc/packages/shared/` | `INT-FR-NNN` |
+
+## Adaptive Flow
+
+See `core/adaptive-flow.md` for complexity assessment (L1-L5).
+See `core/task-registry.md` for task status tracking.
+See `core/security.md` for security baseline (SEC-001~007).
+
+**State file**: `.cdh/state.json`
+
+## Phase Reference
+
+| Phase | Entry | Lifecycle | Rules | Practices |
+|-------|-------|-----------|-------|-----------|
+| 0 Brownfield | `brownfield/entry.md` | `brownfield/README.md` | — | Explore existing codebase |
+| ① Understand | `phases/understand/entry.md` | `phases/understand/lifecycle.md` | `phases/understand/rules.md` | SDD, BDD |
+| ② Plan | `phases/plan/entry.md` | `phases/plan/lifecycle.md` | `phases/plan/rules.md` | SDD, TDD |
+| ③ Verify | `phases/verify/entry.md` | `phases/verify/lifecycle.md` | `phases/verify/rules.md` | BDD, TDD |
+| ④ Deliver | `phases/deliver/entry.md` | `phases/deliver/lifecycle.md` | `phases/deliver/rules.md` | SDD, Cloud |
+| ⑤ Debug | `phases/debug/entry.md` | `phases/debug/lifecycle.md` | — | TCB/云函数日志排查 |
+
+## Sub-agent Delegation
+
+Each phase is delegated via `Task(agent_type="ai-dlc-{phase}")` with the phase's `entry.md` as entry point.
+
+## Key Paths
+
+See `aidlc/CONFIG.md` for full path variable definitions.

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)
+├── aidlc/contracts/           # INT-FR-*      OpenAPI / AsyncAPI / Runtime Contract
+│   ├── api/
+│   ├── events/
+│   └── functions/
+├── aidlc/packages/shared/     # INT-FR-*      从 contracts 生成的共享类型
+├── aidlc/features/            # BDD feature 文件
+│   └── cross-stack/     # 跨组件集成场景
+├── aidlc/tests/
+│   ├── contract/        # 合约测试 (INT-FR 级别, provider-agnostic)
+│   └── cross-stack/     # 跨组件 e2e 测试 (对 STACK_URL 运行)
+├── aidlc/openspec/            # AI-DLC 生命周期产出物
+│   └── changes/{id}/
+│       ├── spec-delta.md
+│       ├── design.md
+│       ├── task-list.md
+│       ├── contract-diff.md
+│       └── walkthrough.md
+├── aidlc/providers/           # 云平台部署配置
+│   ├── tcb/
+│   └── aliyun/
+├── aidlc/tools/               # 脚手架脚本
+│   ├── generate_shared.py
+│   └── contract_diff.py
+├── .opencode/           # OpenCode 配置
+│   └── skills/ai-dlc-skill/
+├── .cdh/                # CDHA 项目状态
+│   ├── config.yaml
+│   ├── state.json
+│   └── SKILL.md
+└── aidlc/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 | `aidlc/contracts/` + `aidlc/packages/shared/` | `aidlc/tests/contract/` | generated types |
+| 跨组件 | `aidlc/features/cross-stack/` | `aidlc/tests/cross-stack/` | STACK_URL |

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

@@ -0,0 +1,36 @@
+# Brownfield 存量项目支持
+
+为已有项目自动生成语义上下文，辅助 AI Agent 理解代码库。
+
+## 使用方式
+
+```bash
+# 一键生成 aidlc/AI-DLC-CONTEXT.md
+./brownfield/generate-context.sh
+
+# 单独步骤
+./brownfield/scripts/discover.sh       # 组件发现
+./brownfield/scripts/extract-api.sh    # API 表面提取
+./brownfield/scripts/deps.sh           # 跨组件依赖图
+```
+
+## 产出
+
+`aidlc/AI-DLC-CONTEXT.md` 文件包含：
+1. 发现的组件列表 + 技术栈
+2. API 端点摘要
+3. 跨组件依赖 Mermaid 图
+4. 架构速览
+
+模板文件位于 `templates/brownfield/context.md`（用于参考格式）。
+
+## 在 Phase 中的应用
+
+Brownfield 是可选的第 0 阶段，在以下情况触发：
+- L2+ 复杂度且有存量代码
+- Master Agent 自动调用 `Task(agent_type="explore", prompt="...brownfield/scripts/...")`
+
+Brownfield Phase 输出用于：
+1. 确认 `affects` 声明的准确性
+2. 发现潜在的跨组件依赖
+3. 为后续 Phase 提供上下文

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

@@ -0,0 +1,45 @@
+---
+name: ai-dlc-brownfield
+description: "Brownfield Phase: Explore existing codebase → Generate AI-DLC Context"
+entry_point: brownfield/entry.md
+triggers:
+  - brownfield
+  - explore
+  - context
+---
+
+# Brownfield Phase (存量探索)
+
+为已有项目自动生成语义上下文，辅助 AI Agent 理解代码库。
+
+## Lifecycle
+
+Brownfield 是可选的第 0 阶段，在 L2+ 复杂度且有存量代码时触发。
+
+## 当被委派时
+
+1. 运行 `brownfield/scripts/discover.sh` 发现组件
+2. 运行 `brownfield/scripts/extract-api.sh` 提取 API 表面
+3. 运行 `brownfield/scripts/deps.sh` 生成跨组件依赖图
+4. 运行 `brownfield/generate-context.sh` 生成 `aidlc/AI-DLC-CONTEXT.md`
+
+## 产出
+
+- `aidlc/AI-DLC-CONTEXT.md` — 包含：
+  - 组件列表 + 技术栈
+  - API 端点摘要
+  - 跨组件依赖 Mermaid 图
+  - 架构速览
+
+## 在 AI-DLC 流程中的应用
+
+Brownfield Phase 输出用于：
+1. 确认 `affects` 声明的准确性
+2. 发现潜在的跨组件依赖
+3. 为后续 Phase 提供上下文
+
+## 约束
+
+- 使用 `explore` agent type 进行代码探索
+- 不修改任何现有代码
+- 专注于生成准确的上下文摘要

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/aidlc/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/aidlc/contracts/api" ]; then
+  find "$PROJECT_ROOT/aidlc/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 aidlc/contracts/ directory
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+
+echo "# API Surface"
+echo ""
+
+if [ ! -d "$PROJECT_ROOT/aidlc/contracts" ]; then
+  echo "(No aidlc/contracts/ directory found)"
+  exit 0
+fi
+
+# OpenAPI
+for f in "$PROJECT_ROOT"/aidlc/contracts/api/*.yaml "$PROJECT_ROOT"/aidlc/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"/aidlc/contracts/events/*.yaml "$PROJECT_ROOT"/aidlc/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,47 @@
+# Backend 组件开发指南 (BE-FR-*)
+
+## 技术栈
+- 语言: Python / Node.js / Go
+- 框架: FastAPI / Express / Gin (传统 server)
+- 云函数: CloudBase Functions (SCF) / CloudBase Run (container)
+- 构建: poetry / pnpm / go build
+- 测试: pytest / vitest / go test
+- BDD: pytest-bdd
+
+## 计算模式
+
+| 模式 | 类型 | 说明 | 超时 | 内存 |
+|------|------|------|------|------|
+| cloudbase-functions | FaaS | CloudBase Functions (SCF)，事件驱动云函数 | 60s | 1536MB |
+| cloudbase-run | CaaS | CloudBase Run，容器托管 | 3600s | 4096MB |
+| server | 传统 | FastAPI / Express / Gin 等框架运行在服务器上 | — | — |
+
+默认模式: `cloudbase-functions`（TCB 平台）。
+
+## 关键命令
+- 构建: `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`
+- 部署云函数: `tcb fn deploy --env {env}`
+- 部署容器: `tcb run deploy --env {env}`
+
+## 目录约定
+- `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 合约定义在 `aidlc/contracts/api/`（OpenAPI 3.1）
+- 依赖注入使用 provider pattern
+- 所有输入必须验证（SEC-002）
+- DB 查询必须使用参数化语句（SEC-003）

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

@@ -0,0 +1,63 @@
+# 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` 在构建时注入
+- 支持离线模式（本地优先）
+- 自动更新通过内置更新器
+
+## Design System 规范
+
+### 必读规范
+| 规范 | 路径 |
+|------|------|
+| Design Tokens | `phases/plan/design_system/design_tokens.md` |
+| Atomic Design | `phases/plan/design_system/atomic_design.md` |
+| Component Spec | `phases/plan/design_system/component_spec.md` |
+| Accessibility | `phases/plan/design_system/accessibility.md` |
+| Theme System | `phases/plan/design_system/theme_system.md` |
+| Desktop UI | `phases/plan/design_system/platform_ui/desktop.md` |
+| Iconography | `phases/plan/design_system/iconography.md` |
+
+### 窗口规范
+| 项目 | 最小尺寸 | 默认尺寸 |
+|------|----------|----------|
+| 通用应用 | 1024x600 | 1280x800 |
+| 复杂工具 | 1280x720 | 1440x900 |
+
+### 平台菜单规范
+| 平台 | 菜单 |
+|------|------|
+| macOS | 原生菜单 (App/File/Edit/View/Window/Help) |
+| Windows | 原生标题栏 + 上下文菜单 |
+| Linux | 原生标题栏 |
+
+### 原生能力
+- 窗口管理: 最小化/最大化/关闭
+- 系统托盘: 后台运行指示器
+- 全局快捷键: 设置/偏好设置/帮助
+- 文件对话框: 打开/保存
+- 拖拽: 支持拖拽文件到窗口