@scemoon/cdh 1.0.0

package/ai-dlc-skill/templates/project/README.md

@@ -0,0 +1,127 @@
+# {{project_name}}
+
+{{description}}
+
+## Stack
+
+| Component | FR Prefix | Default Language | Default UI Framework | Directory | Purpose |
+|-----------|-----------|-----------------|---------------------|-----------|---------|
+| native | `NATIVE-FR-*` | Dart | Flutter SDK | `apps/native/` | Native mobile client |
+| desktop | `DESKTOP-FR-*` | TypeScript | Electron + React | `apps/desktop/` | Desktop client |
+| web | `WEB-FR-*` | TypeScript | Next.js | `apps/web/` | Browser frontend |
+| backend | `BE-FR-*` | Python / Node / Go | FastAPI / Express / Fiber | `apps/backend/` | Service / API |
+| wxa | `WXA-FR-*` | JavaScript | Vant Weapp | `apps/wxa/` | WeChat Mini Program |
+| mya | `MYA-FR-*` | JavaScript | Ant Design Mini | `apps/mya/` | Mini Program (e.g. Alipay) |
+| tta | `TTA-FR-*` | TypeScript | — | `apps/tta/` | TikTok Mini Program |
+| contracts | `INT-FR-*` | — | — | `contracts/`, `packages/shared/` | Cross-component contracts |
+
+Cloud: {{cloud_provider}} (default: TCB).
+
+## Quick Start
+
+```bash
+# ① Understand — declare scope + namespaces
+cat > openspec/changes/CHG-001/spec-delta.md <<'YAML'
+affects: [{{primary_components}}]
+frs:
+  - id: {{primary_namespace}}-FR-001
+  - id: INT-FR-001   # if cross-component
+YAML
+# write features/{component}/{domain}/{feature}.feature
+# if cross-component, also write features/cross-stack/{domain}/{feature}.feature
+
+# ② Plan
+# write openspec/changes/CHG-001/design.md
+# write openspec/changes/CHG-001/task-list.md  (DAG with cross-component edges)
+
+# ③ Verify
+# Per component: TDD red-green-refactor
+{{verify_per_component}}
+# Contracts
+tools/generate_shared.py
+pytest tests/contract/
+# Cross-stack (if applies)
+pytest tests/cross-stack/ -k INT-FR-001
+
+# ④ Deliver
+deploy_stack --preview                                # unified stack URL
+export PREVIEW_URL=$(deploy_stack --preview --output url)
+pytest {e2e_paths} --preview-url $PREVIEW_URL
+deploy_stack --env staging
+deploy_stack --env production                        # after human approval
+bvt ${PRODUCTION_URL}                                # stack-level BVT
+```
+
+## Development
+
+### Prerequisites
+
+- Python 3.11+
+- Node 20+ (for web/native/desktop/mini-programs)
+- uv (Python workspace manager) or pnpm
+- pytest + pytest-bdd + pytest-cov
+- Cloud CLI: `tcb` (TCB) or `fun` (Aliyun)
+
+### Project Structure
+
+```
+{{project_name}}/
+├── project.yaml                 # stack topology, components, contracts
+├── apps/
+│   ├── native/                  # NATIVE-FR-* (native mobile)
+│   ├── desktop/                 # DESKTOP-FR-* (desktop)
+│   ├── web/                     # WEB-FR-*   (browser frontend)
+│   ├── wxa/                     # WXA-FR-*   (WeChat Mini Program)
+│   ├── mya/                     # MYA-FR-*   (Mini Program)
+│   ├── tta/                     # TTA-FR-*   (TikTok Mini Program)
+│   └── backend/                 # BE-FR-*    (service)
+├── contracts/                   # INT-FR-*  (single source of truth)
+│   ├── api/                     # OpenAPI 3.1
+│   ├── events/                  # AsyncAPI / CloudEvent
+│   └── CHANGELOG.md
+├── packages/shared/             # generated from contracts, consumed by all
+├── features/
+│   └── cross-stack/             # INT-FR-*.feature (full flow)
+├── tests/
+│   ├── contract/                # contract tests
+│   └── cross-stack/             # cross-stack e2e
+├── openspec/changes/{id}/       # spec + design + task-list per change
+├── providers/{tcb,aliyun}/      # cloud config
+└── tools/                       # deploy_stack, contract_diff, generate_shared
+```
+
+### AI-DLC Workflow
+
+```bash
+# ① Understand
+# Intent → spec-delta.md (affects + FR namespaces) → feature files
+
+# ② Plan
+# design.md (per-component sections + integration) + task-list.md (DAG)
+
+# ③ Verify (per BDD scenario, per layer)
+{{component_verify_block}}
+# After all components: contract tests + cross-stack e2e
+
+# ④ Deliver
+deploy_stack --preview                          # unified stack URL
+# e2e per affected component
+# cross-stack e2e against unified URL
+deploy_stack --env production                   # after human approval
+bvt ${PRODUCTION_URL}                           # stack BVT
+```
+
+## Quality Gates
+
+| Gate | Command | Threshold | Scope |
+|------|---------|-----------|-------|
+| TDD | `pytest --cov` per component | ≥80% | Per component |
+| BDD | `pytest-bdd features/` per component | 100% pass | Per component |
+| Contract | `pytest tests/contract/` | 100% pass | Cross-component |
+| Cross-stack | `pytest tests/cross-stack/` | 100% pass | Stack |
+| Security | `bandit -r apps/` | 0 vulns | Per component |
+| BVT | `bvt ${URL}` | All checks pass | Stack |
+
+## License
+
+{{license}}

package/ai-dlc-skill/templates/project/template.md

@@ -0,0 +1,119 @@
+# {{project_name}}
+
+AI-DLC monorepo project. Stack: native + desktop + web + backend + wxa + mya + tta with cross-component contracts.
+
+## Project Layout
+
+```
+{{project_name}}/
+├── project.yaml                       # Stack topology
+├── requirements.md                    # Intent + global spec
+├── apps/
+│   ├── native/                        # NATIVE-FR-* native mobile
+│   │   ├── src/
+│   │   ├── tests/{unit,e2e}/
+│   │   └── features/
+│   ├── desktop/                       # DESKTOP-FR-* desktop
+│   │   ├── src/
+│   │   ├── tests/{unit,e2e}/
+│   │   └── features/
+│   ├── web/                           # WEB-FR-*    browser frontend
+│   │   ├── src/
+│   │   ├── tests/{unit,integration,e2e}/
+│   │   └── features/
+│   ├── wxa/                           # WXA-FR-*    WeChat Mini Program
+│   │   ├── src/
+│   │   ├── tests/{e2e}/
+│   │   └── features/
+│   ├── mya/                           # MYA-FR-*    Mini Program
+│   │   ├── src/
+│   │   ├── tests/{e2e}/
+│   │   └── features/
+│   ├── tta/                           # TTA-FR-*    TikTok Mini Program
+│   │   ├── src/
+│   │   ├── tests/{e2e}/
+│   │   └── features/
+│   └── backend/                       # BE-FR-*     service / API
+│       ├── src/
+│       ├── tests/{unit,integration,e2e}/
+│       └── features/
+├── contracts/                         # INT-FR-*   single source of truth
+│   ├── api/                           # OpenAPI 3.1
+│   ├── events/                        # AsyncAPI / CloudEvent
+│   └── CHANGELOG.md
+├── packages/shared/                   # generated from contracts
+├── features/cross-stack/              # INT-FR-*.feature full flow
+├── tests/
+│   ├── contract/                      # INT contract tests
+│   └── cross-stack/                   # cross-stack e2e
+├── openspec/changes/{id}/
+│   ├── spec-delta.md                  # declares affects + FR namespaces
+│   ├── design.md                      # per-component + integration
+│   ├── task-list.md                   # DAG with cross-component edges
+│   └── contract-diff.md               # auto-generated contract changes
+├── providers/{tcb,aliyun}/
+└── tools/
+    ├── deploy_stack.py                # unified stack deploy
+    ├── contract_diff.py               # contract compat check
+    └── generate_shared.py             # contracts → packages/shared
+```
+
+## project.yaml
+
+```yaml
+stack:
+  topology: monorepo
+  components:
+    - id: native    { fr_prefix: NATIVE, tech: react-native | flutter,        dir: apps/native,  default_language: dart,        default_ui_framework: flutter-sdk }
+    - id: desktop   { fr_prefix: DESKTOP, tech: electron | tauri,            dir: apps/desktop, default_language: typescript,   default_ui_framework: electron-react }
+    - id: web       { fr_prefix: WEB,    tech: react | vue | svelte,        dir: apps/web,     default_language: typescript,   default_ui_framework: nextjs }
+    - id: backend   { fr_prefix: BE,     tech: python | node | go,          dir: apps/backend }
+    - id: wxa       { fr_prefix: WXA,    tech: miniprogram,                 dir: apps/wxa,     default_language: javascript,   default_ui_framework: vant-weapp }
+    - id: mya       { fr_prefix: MYA,    tech: miniprogram,                 dir: apps/mya,     default_language: javascript,   default_ui_framework: ant-design-mini }
+    - id: tta       { fr_prefix: TTA,    tech: miniprogram,                 dir: apps/tta,     default_language: typescript }
+  cross_cutting:
+    fr_prefix: INT
+    contracts: contracts/
+    shared_types: packages/shared/
+```
+
+## AI-DLC Workflow
+
+```bash
+# ① Understand
+# requirements.md → openspec/changes/{id}/spec-delta.md (with affects)
+# → features/{component}/{domain}/{feature}.feature
+# → features/cross-stack/{domain}/{feature}.feature  (if cross-component)
+
+# ② Plan
+# → openspec/changes/{id}/design.md  (per-component + integration)
+# → openspec/changes/{id}/task-list.md (DAG with cross-component edges)
+
+# ③ Verify
+# For each affected component, per BDD scenario: RED → GREEN → REFACTOR
+# Then: tools/generate_shared.py  →  pytest tests/contract/
+# Then: pytest tests/cross-stack/  (if cross-component)
+
+# ④ Deliver
+deploy_stack --preview                # unified stack URL
+# per-component e2e + cross-stack e2e against PREVIEW_URL
+deploy_stack --env staging
+deploy_stack --env production         # after human approval
+bvt ${PRODUCTION_URL}                 # stack BVT
+```
+
+## Quality Gates
+
+| Gate | Command | Threshold |
+|------|---------|-----------|
+| TDD coverage | `pytest --cov` per component | ≥80% |
+| BDD scenarios | `pytest-bdd features/` per component | 100% pass |
+| Contract | `pytest tests/contract/` | 100% pass |
+| Cross-stack e2e | `pytest tests/cross-stack/` | 100% pass |
+| Contract diff | `tools/contract_diff.py` | backward-compat |
+| Security | `bandit -r apps/` | 0 vulns |
+| Stack BVT | `bvt ${URL}` | all checks pass |
+
+## License
+
+{{license}}

package/ai-dlc-skill/templates/understand/feature.feature

@@ -0,0 +1,23 @@
+@FR-{{fr_id}}
+Feature: {{feature_name}}
+
+  {{feature_description}}
+
+  @FR-{{fr_id}} @positive
+  Scenario: {{positive_scenario_name}}
+    Given {{precondition}}
+    When {{action}}
+    Then {{expected_outcome}}
+    And {{additional_outcome}}
+
+  @FR-{{fr_id}} @negative
+  Scenario: {{negative_scenario_name}}
+    Given {{precondition}}
+    When {{action_with_invalid_input}}
+    Then {{expected_error}}
+
+  @FR-{{fr_id}} @edge
+  Scenario: {{edge_case_scenario_name}}
+    Given {{precondition}}
+    When {{action_with_boundary_input}}
+    Then {{expected_outcome}}

package/ai-dlc-skill/templates/understand/intent.md

@@ -0,0 +1,29 @@
+# Intent — {{feature_name}}
+
+## Why
+
+{{why_this_feature_is_needed}}
+
+## What
+
+{{what_the_feature_does}}
+
+## Success Criteria
+
+- {{criterion_1}}
+- {{criterion_2}}
+
+## Scope
+
+### In Scope
+- {{in_scope_item_1}}
+- {{in_scope_item_2}}
+
+### Out of Scope
+- {{out_of_scope_item_1}}
+- {{out_of_scope_item_2}}
+
+## Dependencies
+
+- {{dependency_1}}
+- {{dependency_2}}

package/ai-dlc-skill/templates/understand/spec-delta.md

@@ -0,0 +1,47 @@
+# Spec Delta — {{change_id}}
+
+## Change Information
+
+| Field | Value |
+|-------|-------|
+| Change ID | `{{change_id}}` |
+| FR ID | `{{fr_id}}` |
+| Type | {{type: NEW | ENHANCEMENT | FIX}} |
+| Priority | {{priority: P0 | P1 | P2}} |
+| Status | Draft → Review → Approved |
+
+## ADDED Requirements
+
+### FR-{{number}}: {{title}}
+
+**Priority:** {{priority}}
+
+**Description (EARS):**
+{{ears_description}}
+
+**Acceptance Criteria:**
+- AC1: {{positive_case}}
+- AC2: {{negative_case}}
+- AC3: {{edge_case}}
+
+**BDD Scenarios:**
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{number}} @positive
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{number}} @negative
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{number}} @edge
+
+## MODIFIED Requirements
+
+_(if applicable)_
+
+### FR-{{number}}: {{previous_title}}
+
+**Change:** {{what_changed}}
+**Reason:** {{why}}
+
+## REMOVED Requirements
+
+_(if applicable)_
+
+### FR-{{number}}: {{removed_title}}
+
+**Reason:** {{why_removed}}

package/ai-dlc-skill/templates/verify/test-unit.py

@@ -0,0 +1,27 @@
+"""TDD unit tests for {{feature_name}}.
+
+BDD scenario: {{scenario_ref}}
+FR ID: {{fr_id}}
+"""
+
+import pytest
+from src.{{module}} import {{function_under_test}}
+
+
+class Test{{feature_class_name}}:
+    """TDD cycle: RED → GREEN → REFACTOR."""
+
+    def test_{{positive_case}}(self):
+        """RED: Write test → confirm fail. GREEN: Implement → pass."""
+        result = {{function_under_test}}({{valid_input}})
+        assert result == {{expected_output}}
+
+    def test_{{negative_case}}(self):
+        """Negative case: should handle invalid input."""
+        with pytest.raises({{expected_exception}}):
+            {{function_under_test}}({{invalid_input}})
+
+    def test_{{edge_case}}(self):
+        """Edge case: boundary condition."""
+        result = {{function_under_test}}({{boundary_input}})
+        assert result == {{expected_output}}

package/ai-dlc-skill/walkthrough/collect.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# collect.sh — Collect phase artifacts and generate walkthrough
+set -euo pipefail
+
+CHANGE_ID="${1:?Usage: collect.sh <change-id>}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+CHANGE_DIR="$PROJECT_ROOT/openspec/changes/$CHANGE_ID"
+
+if [ ! -d "$CHANGE_DIR" ]; then
+  echo "Error: $CHANGE_DIR not found"
+  exit 1
+fi
+
+OUTPUT="$CHANGE_DIR/walkthrough.md"
+
+# Read artifacts and compose walkthrough
+SPEC_DELTA="$CHANGE_DIR/spec-delta.md"
+DESIGN="$CHANGE_DIR/design.md"
+TASK_LIST="$CHANGE_DIR/task-list.md"
+CONTRACT_DIFF="$CHANGE_DIR/contract-diff.md"
+
+echo "# Walkthrough — Change $CHANGE_ID" > "$OUTPUT"
+echo "" >> "$OUTPUT"
+echo "> Auto-generated by AI-DLC Walkthrough System" >> "$OUTPUT"
+echo "" >> "$OUTPUT"
+
+if [ -f "$SPEC_DELTA" ]; then
+  echo "## Understand" >> "$OUTPUT"
+  head -20 "$SPEC_DELTA" >> "$OUTPUT"
+  echo "" >> "$OUTPUT"
+fi
+
+if [ -f "$DESIGN" ]; then
+  echo "## Plan" >> "$OUTPUT"
+  head -30 "$DESIGN" >> "$OUTPUT"
+  echo "" >> "$OUTPUT"
+fi
+
+if [ -f "$CONTRACT_DIFF" ]; then
+  echo "## Contract Diff" >> "$OUTPUT"
+  cat "$CONTRACT_DIFF" >> "$OUTPUT"
+  echo "" >> "$OUTPUT"
+fi
+
+echo "---" >> "$OUTPUT"
+echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$OUTPUT"
+
+echo "✓ Walkthrough generated: $OUTPUT"

package/ai-dlc-skill/walkthrough/template.md

@@ -0,0 +1,54 @@
+# Walkthrough — {{change_title}}
+
+> Auto-generated by AI-DLC Walkthrough System
+
+## 变更摘要
+
+| 字段 | 值 |
+|------|-----|
+| Change ID | `{{change_id}}` |
+| Affects | `[{{components}}]` |
+| Complexity | L{{level}} |
+| FRs | {{fr_list}} |
+| 状态 | {{status}} |
+
+## Phase By Phase
+
+### Understand
+- Spec Delta: `openspec/changes/{{change_id}}/spec-delta.md`
+- BDD 场景数: {{scenario_count}}
+  - Positive: {{positive_count}}
+  - Negative: {{negative_count}}
+  - Edge: {{edge_count}}
+
+### Plan
+- Design Doc: `openspec/changes/{{change_id}}/design.md`
+- Task DAG: {{task_count}} units
+- 跨组件依赖: {{cross_component_edges}}
+
+### Verify
+- 测试通过率: {{test_pass_rate}}%
+- 覆盖率: {{coverage}}%
+- 合约兼容: {{contract_compat}}
+- 质量门禁: {{quality_gate_status}}
+
+### Deliver
+- 环境: {{environment}}
+- BVT: {{bvt_status}}
+- 部署版本: {{deploy_version}}
+
+## 关键决策
+
+{{key_decisions}}
+
+## 风险记录
+
+{{risks}}
+
+## 变更文件
+
+{{changed_files_list}}
+
+---
+
+*Walkthrough generated on {{date}}*

package/ai-dlc-skill/workflows/ai-dlc.yaml

@@ -0,0 +1,110 @@
+name: ai-dlc
+version: 4.0.0
+description: >
+  AI-DLC adaptive workflow for monorepo multi-component stacks.
+  Master Agent evaluates complexity (L1-L5), selects phases, delegates
+  via Task(general) agents. See core/adaptive-flow.md.
+
+stack:
+  topology: monorepo
+  components: [native, desktop, web, backend, wxa, mya, tta]
+  fr_namespaces:
+    native: NATIVE-*
+    desktop: DESKTOP-*
+    web: WEB-*
+    backend: BE-*
+    wxa: WXA-*
+    mya: MYA-*
+    tta: TTA-*
+    contracts: INT-*
+
+phases:
+  - name: understand
+    label: "① Understand — 理解"
+    description: >
+      Capture intent, declare affects, produce spec delta (EARS),
+      write BDD feature files.
+    entry: phases/understand/prompt.md
+    lifecycle: phases/understand/lifecycle.md
+    rules: phases/understand/rules.md
+    practices:
+      - sdd
+      - bdd
+      - integration
+    gates:
+      - UND-001..006: Understand rules
+      - Human review and approval
+    artifacts:
+      - requirements.md
+      - openspec/changes/{id}/spec-delta.md
+      - apps/{component}/features/{domain}/{feature}.feature
+      - features/cross-stack/{domain}/{feature}.feature
+      - contracts/api|events/{name}.{yaml,graphql}
+
+  - name: plan
+    label: "② Plan — 规划"
+    description: >
+      Design solution per-component + integration, decompose into DAG
+      units, write test plans per layer.
+    entry: phases/plan/prompt.md
+    lifecycle: phases/plan/lifecycle.md
+    rules: phases/plan/rules.md
+    practices:
+      - sdd
+      - tdd
+      - integration
+    gates:
+      - PLN-001..004: Plan rules
+      - Human review and approval
+    artifacts:
+      - openspec/changes/{id}/design.md
+      - openspec/changes/{id}/task-list.md
+      - openspec/changes/{id}/contract-diff.md
+
+  - name: verify
+    label: "③ Verify — 验证"
+    description: >
+      TDD red-green-refactor per scenario, contract verification,
+      cross-stack e2e, quality gates.
+    entry: phases/verify/prompt.md
+    lifecycle: phases/verify/lifecycle.md
+    rules: phases/verify/rules.md
+    practices:
+      - bdd
+      - tdd
+      - integration
+    gates:
+      - VRF-001..006: Verify rules
+      - INT-001..006: Integration rules
+      - STK-001..006: Stack rules
+    artifacts:
+      - apps/{component}/tests/{unit,integration,e2e}/test_{feature}.py
+      - apps/{component}/features/steps/test_{feature}_steps.py
+      - apps/{component}/src/{module}/{feature}.py
+      - tests/contract/test_{contract}.py
+      - tests/cross-stack/test_{flow}.py
+      - packages/shared/
+      - openspec/changes/{id}/contract-diff.md
+
+  - name: deliver
+    label: "④ Deliver — 交付"
+    description: >
+      Unified stack preview, per-component e2e, cross-stack e2e,
+      staging, human approval, production BVT + stack rollback.
+    entry: phases/deliver/prompt.md
+    lifecycle: phases/deliver/lifecycle.md
+    rules: phases/deliver/rules.md
+    practices:
+      - sdd
+      - cloud
+      - integration
+    gates:
+      - DLV-001..004: Deliver rules
+      - STK-004..006: Stack deploy rules
+    artifacts:
+      - STACK_URL / BACKEND_URL
+      - Per-component e2e report
+      - Cross-stack e2e report
+      - openspec/changes/{id}/contract-diff.md
+      - Stack BVT report
+      - Deploy log