@scemoon/cdh 1.0.7 → 1.0.9-beta.1

package/ai-dlc-skill/templates/integration/contract-spec.md

@@ -0,0 +1,49 @@
+# Contract Spec — {{contract_name}}
+
+> Source of truth for cross-component contract. Implements `INT-FR-{{int_fr_id}}`.
+> Consumers: {{consumers}}
+> Producers: {{producers}}
+
+## Kind
+
+- [ ] REST API (OpenAPI 3.1) — `aidlc/contracts/api/{{name}}.yaml`
+- [ ] AsyncAPI event — `aidlc/contracts/events/{{name}}.yaml`
+- [ ] GraphQL schema — `aidlc/contracts/api/{{name}}.graphql`
+
+## Versioning
+
+- Current version: `{{version}}`  (SemVer: MAJOR.MINOR.PATCH)
+- MAJOR: breaking (field removed, type changed, status code changed)
+- MINOR: additive (new optional field, new endpoint)
+- PATCH: doc / example only
+
+> Any MAJOR bump requires human approval (INT-002) and a migration note in
+> `aidlc/contracts/CHANGELOG.md`.
+
+## Change
+
+| Field | Value |
+|-------|-------|
+| Change ID | `{{change_id}}` |
+| Affects | {{affects: [native, desktop, web, backend, wxa, mya, tta]}} |
+| Direction | {{provider → consumer / bidirectional}} |
+| Breaking? | {{yes / no}} |
+| Migration | {{link to migration doc or "none"}} |
+
+## FR Mapping
+
+| FR | Component | Role |
+|----|-----------|------|
+| `INT-FR-{{int_fr_id}}` | contracts | Contract definition |
+| `{{provider_namespace}}-FR-{{provider_fr}}` | {{provider}} | Provider behavior |
+| `{{consumer_namespace}}-FR-{{consumer_fr}}` | {{consumer}} | Consumer behavior |
+
+## Contract Test Mapping
+
+- `aidlc/tests/contract/test_{{contract_name}}.py`
+- Scenarios: @INT-FR-{{int_fr_id}} @positive / @negative / @edge
+
+## See Also
+
+- `aidlc/contracts/CHANGELOG.md` — version history
+- `aidlc/openspec/changes/{{change_id}}/contract-diff.md` — auto-generated diff

package/ai-dlc-skill/templates/integration/openapi.yaml

@@ -0,0 +1,18 @@
+openapi: 3.1.0
+info:
+  title: {{title}}
+  version: {{version}}
+  description: |
+    Implements INT-FR-{{int_fr_id}}.
+    Consumers: {{consumers}}
+    Producers: {{producers}}
+  x-change-id: {{change_id}}
+  x-fr: INT-FR-{{int_fr_id}}
+
+servers:
+  - url: ${BACKEND_URL}
+    description: Stack preview / staging / production (URL injected at deploy)
+
+paths:
+  /{{resource}}:
+    {{methods}}

package/ai-dlc-skill/templates/integration/runtime-contract.yaml

@@ -0,0 +1,36 @@
+# Runtime Contract 模板 — Serverless 函数接口声明
+# Provider-agnostic: 描述函数"做什么"，不涉及具体部署平台
+# 放置在 aidlc/contracts/functions/{name}.yaml
+
+function: {{function_name}}
+version: {{semver}}
+fr_ref: {{INT-FR-NNN}}
+description: {{description}}
+
+triggers:
+  - type: http            # http | timer | event | oss | mns
+    method: POST
+    path: /{{endpoint}}
+  - type: event
+    source: {{event_source}}
+
+timeout: {{timeout}}s
+memory: {{memory}}MB
+
+env:
+  {{env_var_name}}: {from: {{source}}}  # stack_env | secrets | literal
+
+# Provider-specific 映射 (自动选择)
+# 部署时根据 --provider + --compute-mode 选择合适的 runtime
+provider_map:
+  tcb:
+    compute_mode: cloudbase-functions
+    runtime: nodejs18 | python3.10 | go1.18
+  aliyun:
+    compute_mode: fc           # Function Compute
+    runtime: python3.10 | nodejs18
+    # 或 SAE 模式 (container):
+    sae:
+      type: web-app
+      port: 8080
+      health_check: /health

package/ai-dlc-skill/templates/plan/design.md

@@ -0,0 +1,49 @@
+# Technical Design — {{feature_name}}
+
+## Overview
+
+{{brief_description}}
+
+## Architecture
+
+```
+[Client] → [API Gateway] → [Function] → [Database]
+```
+
+## Data Model
+
+```python
+@dataclass
+class {{model_name}}:
+    id: str
+    {{field_1}}: {{type_1}}
+    {{field_2}}: {{type_2}}
+```
+
+| Field | Type | Constraints | Description |
+|-------|------|-------------|-------------|
+| {{field}} | {{type}} | {{constraints}} | {{description}} |
+
+## API Contract
+
+| Method | Path | Request | Response | Status |
+|--------|------|---------|----------|--------|
+| {{method}} | {{path}} | {{request}} | {{response}} | {{status_code}} |
+
+## State Machine
+
+```
+{{state_a}} → {{state_b}} → {{state_c}}
+{{state_b}} → {{error_state}}  (on validation failure)
+```
+
+## Dependencies
+
+- {{dependency_1}}
+- {{dependency_2}}
+
+## BDD Scenarios
+
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{fr_id}} @positive
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{fr_id}} @negative
+- `features/{{domain}}/{{feature}}.feature` — @FR-{{fr_id}} @edge

package/ai-dlc-skill/templates/plan/task-list.md

@@ -0,0 +1,32 @@
+# Task List — {{feature_name}}
+
+## Dependency Graph
+
+```mermaid
+graph TD
+  {{dag_nodes}}
+```
+
+## Units
+
+### Unit 1: {{unit_1_name}}
+
+- **Depends on:** none
+- **Scenarios:** {{scenario_tags_1}}
+- **Tasks:**
+  - [ ] {{task_1}}
+  - [ ] {{task_2}}
+- **Test plan:**
+  - `test_{{case_1}}` → {{expected_1}}
+  - `test_{{case_2}}` → {{expected_2}}
+
+### Unit 2: {{unit_2_name}}
+
+- **Depends on:** {{unit_1_name}}
+- **Scenarios:** {{scenario_tags_2}}
+- **Tasks:**
+  - [ ] {{task_1}}
+  - [ ] {{task_2}}
+- **Test plan:**
+  - `test_{{case_1}}` → {{expected_1}}
+  - `test_{{case_2}}` → {{expected_2}}

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

@@ -0,0 +1,126 @@
+# {{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-*` | — | — | `aidlc/contracts/`, `aidlc/packages/shared/` | Cross-component contracts |
+
+Cloud: {{cloud_provider}} (default: TCB).
+
+## Quick Start
+
+```bash
+# ① Understand — declare scope + namespaces
+cat > aidlc/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 aidlc/features/cross-stack/{domain}/{feature}.feature
+
+# ② Plan
+# write aidlc/openspec/changes/CHG-001/design.md
+# write aidlc/openspec/changes/CHG-001/task-list.md  (DAG with cross-component edges)
+
+# ③ Verify
+# Per component: TDD red-green-refactor
+{{verify_per_component}}
+# Contracts
+aidlc/tools/generate_shared.py
+pytest aidlc/tests/contract/
+# Cross-stack (if applies)
+pytest aidlc/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}}/
+├── aidlc/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)
+├── aidlc/contracts/                   # INT-FR-*  (single source of truth)
+│   ├── api/                     # OpenAPI 3.1
+│   ├── events/                  # AsyncAPI / CloudEvent
+│   └── CHANGELOG.md
+├── aidlc/packages/shared/             # generated from contracts, consumed by all
+├── aidlc/features/cross-stack/        # INT-FR-*.feature (full flow)
+├── aidlc/tests/
+│   ├── contract/                # contract tests
+│   └── cross-stack/             # cross-stack e2e
+├── aidlc/openspec/changes/{id}/ # spec + design + task-list per change
+├── aidlc/providers/{tcb,aliyun}/      # cloud config
+└── aidlc/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 aidlc/tests/contract/` | 100% pass | Cross-component |
+| Cross-stack | `pytest aidlc/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}}/
+├── aidlc/project.yaml                 # Stack topology
+├── aidlc/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/
+├── aidlc/contracts/                         # INT-FR-*   single source of truth
+│   ├── api/                           # OpenAPI 3.1
+│   ├── events/                        # AsyncAPI / CloudEvent
+│   └── CHANGELOG.md
+├── aidlc/packages/shared/                   # generated from contracts
+├── aidlc/features/cross-stack/              # INT-FR-*.feature full flow
+├── aidlc/tests/
+│   ├── contract/                      # INT contract tests
+│   └── cross-stack/                   # cross-stack e2e
+├── aidlc/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
+├── aidlc/providers/{tcb,aliyun}/
+└── aidlc/tools/
+    ├── deploy_stack.py                # unified stack deploy
+    ├── contract_diff.py               # contract compat check
+    └── generate_shared.py             # contracts → aidlc/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: aidlc/contracts/
+    shared_types: aidlc/packages/shared/
+```
+
+## AI-DLC Workflow
+
+```bash
+# ① Understand
+# aidlc/requirements.md → aidlc/openspec/changes/{id}/spec-delta.md (with affects)
+# → features/{component}/{domain}/{feature}.feature
+# → aidlc/features/cross-stack/{domain}/{feature}.feature  (if cross-component)
+
+# ② Plan
+# → aidlc/openspec/changes/{id}/design.md  (per-component + integration)
+# → aidlc/openspec/changes/{id}/task-list.md (DAG with cross-component edges)
+
+# ③ Verify
+# For each affected component, per BDD scenario: RED → GREEN → REFACTOR
+# Then: aidlc/tools/generate_shared.py  →  pytest aidlc/tests/contract/
+# Then: pytest aidlc/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 aidlc/tests/contract/` | 100% pass |
+| Cross-stack e2e | `pytest aidlc/tests/cross-stack/` | 100% pass |
+| Contract diff | `aidlc/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,30 @@
+@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}}
+
+  @FR-{{fr_id}} @logic
+  Scenario: {{logic_scenario_name}}
+    Given {{precondition_with_state}}
+    When {{action}} is repeated multiple times
+    Then {{outcome}} remains consistent
+    And {{side_effects}} do not accumulate

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/aidlc/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: `aidlc/openspec/changes/{{change_id}}/spec-delta.md`
+- BDD 场景数: {{scenario_count}}
+  - Positive: {{positive_count}}
+  - Negative: {{negative_count}}
+  - Edge: {{edge_count}}
+
+### Plan
+- Design Doc: `aidlc/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/cdh/__main__.py

@@ -0,0 +1,4 @@
+from cdh.cli import main
+
+if __name__ == "__main__":
+    main()