@scemoon/cdh 1.0.5 → 1.0.7

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@scemoon/cdh",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Cloud Dev Harness - cloud-native development Agent framework",
-  "keywords": ["ai", "agent", "cloud", "development", "cli", "tui"],
+  "keywords": ["ai", "agent", "cloud", "development", "cli", "cdc"],
   "license": "MIT",
   "repository": {
     "type": "git",

package/run.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-const { spawn, execSync } = require('child_process');
+const { spawn, spawnSync, execSync } = require('child_process');
 const path = require('path');
+const fs = require('fs');
+const os = require('os');
 const pkg = require('./package.json');
 
 function exec(cmd, opts = {}) {
@@ -11,6 +13,12 @@ function exec(cmd, opts = {}) {
   }
 }
 
+function execVerbose(cmd, label) {
+  if (label) console.log(`cdh: ${label}`);
+  const r = spawnSync(cmd, { shell: true, stdio: 'inherit' });
+  return { ok: r.status === 0 };
+}
+
 function checkPython() {
   const script = 'import sys; v=sys.version_info; print(f"{v.major}.{v.minor}")';
   const r = exec(`python3 -c "${script}"`);
@@ -32,11 +40,49 @@ function checkCdhInstalled(pythonCmd) {
   return exec(`${pythonCmd} -m pip show cloud-dev-harness 2>/dev/null`).ok;
 }
 
+function uninstallCmd() {
+  const cdhDir = path.join(os.homedir(), '.cdh');
+  const pythonDir = path.join(cdhDir, 'python');
+
+  console.log('cdh: Uninstalling Cloud Dev Harness...');
+  console.log('');
+
+  if (fs.existsSync(pythonDir)) {
+    console.log(`cdh: Removing Python environment at ${pythonDir}...`);
+    fs.rmSync(pythonDir, { recursive: true, force: true });
+  }
+
+  if (fs.existsSync(cdhDir)) {
+    console.log(`cdh: Removing global state at ${cdhDir}...`);
+    fs.rmSync(cdhDir, { recursive: true, force: true });
+  }
+
+  console.log('');
+  console.log('cdh: Cleanup complete. To finish uninstall:');
+  console.log('');
+  console.log('  1. Remove the npm package:');
+  console.log('     pnpm remove -g @scemoon/cdh');
+  console.log('     # or: npm uninstall -g @scemoon/cdh');
+  console.log('');
+  console.log('  2. Check your shell config (~/.zshrc, ~/.bashrc, etc.) for:');
+  console.log('     export PATH="$HOME/.cdh/python/bin:$PATH"');
+  console.log('     Remove this line if present.');
+  console.log('');
+
+  process.exit(0);
+}
+
 function run(pythonModule) {
   const PKG_DIR = __dirname;
-  const PYTHON_ENV_DIR = path.join(require('os').homedir(), '.cdh', 'python');
+  const PYTHON_ENV_DIR = path.join(os.homedir(), '.cdh', 'python');
 
   const args = process.argv.slice(2);
+
+  if (args[0] === 'uninstall') {
+    uninstallCmd();
+    return;
+  }
+
   if (args.includes('--version') || args.includes('-v')) {
     console.log(pkg.version);
     process.exit(0);
@@ -49,13 +95,19 @@ function run(pythonModule) {
     console.error(`cdh: Python ${py.version || 'not found'}, version 3.14+ is required.`);
 
     if (checkUv()) {
-      console.log('cdh: Creating Python environment with uv...');
-      exec(`uv venv "${PYTHON_ENV_DIR}"`);
+      if (fs.existsSync(PYTHON_ENV_DIR)) {
+        console.log('cdh: Python environment exists, reusing...');
+      } else {
+        const rv = execVerbose(`uv venv "${PYTHON_ENV_DIR}"`, 'Creating Python environment with uv...');
+        if (!rv.ok) {
+          console.error('cdh: Failed to create Python environment.');
+          process.exit(1);
+        }
+      }
       const venvPython = path.join(PYTHON_ENV_DIR, 'bin', 'python');
-      console.log('cdh: Installing cloud-dev-harness...');
-      const r = exec(`uv pip install "${PKG_DIR}" --python "${venvPython}"`);
-      if (!r.ok) {
-        console.error('cdh: Install failed:', r.out);
+      const ri = execVerbose(`uv pip install "${PKG_DIR}" --python "${venvPython}"`, 'Installing cloud-dev-harness...');
+      if (!ri.ok) {
+        console.error('cdh: Install failed.');
         process.exit(1);
       }
       if (isPostinstall) {
@@ -72,12 +124,14 @@ function run(pythonModule) {
   }
 
   if (!checkCdhInstalled(py.pythonCmd)) {
-    console.log('cdh: Installing cloud-dev-harness...');
-    const r = checkUv()
-      ? exec(`uv pip install "${PKG_DIR}" --python "${py.pythonCmd}"`)
-      : exec(`${py.pythonCmd} -m pip install "${PKG_DIR}"`);
-    if (!r.ok) {
-      console.error('cdh: Install failed:', r.out);
+    let ri;
+    if (checkUv()) {
+      ri = execVerbose(`uv pip install "${PKG_DIR}" --python "${py.pythonCmd}"`, 'Installing cloud-dev-harness...');
+    } else {
+      ri = execVerbose(`${py.pythonCmd} -m pip install "${PKG_DIR}"`, 'Installing cloud-dev-harness...');
+    }
+    if (!ri.ok) {
+      console.error('cdh: Install failed.');
       process.exit(1);
     }
   }

package/ai-dlc-skill/SKILL.md

@@ -1,77 +0,0 @@
----
-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 | `aidlc/contracts/`, `aidlc/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 `Spawn(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

@@ -1,24 +0,0 @@
-# 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

@@ -1,50 +0,0 @@
-# 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）暂停等待用户确认
-
-## ⚠️ 角色边界（重要）
-
-- **你（主 Agent）负责所有规划**：分析复杂度、创建 TODO、判断直行还是 Spawn
-- **子 Agent 是叶子节点**：只做实现，不可嵌套
-- **禁止**：把"分析复杂度"或"判断是否 Spawn"的逻辑下放给子 Agent
-
-## 复杂度判断
-
-见 `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

@@ -1,23 +0,0 @@
-# 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 → `aidlc/openspec/changes/{id}/design.md`
-2. Task DAG → `aidlc/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

@@ -1,23 +0,0 @@
-# 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 捕获 → `aidlc/requirements.md`
-2. Spec Delta (EARS) → `aidlc/openspec/changes/{id}/spec-delta.md`
-3. BDD Feature 文件 → `apps/{component}/features/`
-4. 跨组件 Feature 文件 → `aidlc/features/cross-stack/`（如适用）
-5. 合约文件 → `aidlc/contracts/{api,events}/`（跨组件时）
-
-## 约束
-
-- 遵守 `core/security.md`
-- 完成前必须通过 Human Gate

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

@@ -1,27 +0,0 @@
-# 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 → `aidlc/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

@@ -1,78 +0,0 @@
-# 项目工程目录架构
-
-## 顶层布局
-
-```
-{{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

@@ -1,30 +0,0 @@
-# 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. 架构速览
-
-## 在 Phase 中的应用
-
-Master Agent 在 `affects` 声明后自动触发 Brownfield Phase：
-```
-L2+ 且有存量代码 → Task(agent_type="explore", prompt="...brownfield/scripts/...")
-```

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

@@ -1,64 +0,0 @@
-#!/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

@@ -1,27 +0,0 @@
-#!/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

@@ -1,34 +0,0 @@
-#!/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

@@ -1,45 +0,0 @@
-#!/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

@@ -1,34 +0,0 @@
-# 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 合约定义在 `aidlc/contracts/api/`（OpenAPI 3.1）
-- 依赖注入使用 provider pattern
-- 所有输入必须验证（SEC-002）
-- DB 查询必须使用参数化语句（SEC-003）