@scemoon/cdh 1.0.8 → 1.0.9-beta.2

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

@@ -0,0 +1,219 @@
+# WXA 组件开发指南 (WXA-FR-*) — 微信小程序
+
+## 技术栈
+
+| 类别 | 选项 | 说明 |
+|------|------|------|
+| 框架 | 微信原生 / Taro / uni-app | 原生适合轻量；Taro/uni-app 适合多端复用 |
+| 语言 | JavaScript / TypeScript | 推荐 TypeScript（类型安全） |
+| UI 组件库 | Vant Weapp / WeUI / ColorUI | 默认 Vant Weapp（per skill.yaml） |
+| 云服务 | 微信云开发 / TCB | TCB 为默认云 provider |
+| 构建 | 微信开发者工具 / Taro CLI / Vite | Taro 项目用 CLI，原生用开发者工具 |
+| 测试 | Jest / miniprogram-simtest | 单元测试用 Jest |
+| 自动化 | miniprogram-automator | UI 自动化测试 |
+| BDD | pytest-bdd + miniprogram-automator | E2E BDD 场景 |
+
+## 计算模式
+
+| 模式 | 类型 | 说明 |
+|------|------|------|
+| wx.cloud | 云开发 | 微信自带云能力，无需自建后端 |
+| tcb | CloudBase | TCB 平台，FaaS 云函数 |
+| 混合 | 微信云 + TCB | 微信云存储 + TCB 云函数 |
+
+默认模式: `tcb`（TCB 平台，与其他组件统一）。
+
+## 关键命令
+
+```bash
+# 构建
+pnpm --filter wxa build
+
+# 测试
+pnpm --filter wxa test              # 单元测试
+pytest apps/wxa/tests/e2e/ --backend-url $BACKEND_URL  # E2E BDD
+
+# Lint
+pnpm --filter wxa lint
+
+# 预览（上传至微信小程序平台，获取预览二维码）
+pnpm --filter wxa preview
+
+# 分包构建（如使用分包）
+pnpm --filter wxa build --type=plugin
+```
+
+## 目录约定
+
+```
+apps/wxa/
+├── src/
+│   ├── components/          # 业务组件
+│   ├── pages/               # 页面（按分包组织）
+│   ├── subpackages/         # 分包（主包超出 2MB 时拆离）
+│   ├── services/            # API 调用层（统一用 BACKEND_URL）
+│   ├── store/               # 状态管理（推荐 mobx-miniprogram）
+│   ├── utils/               # 工具函数
+│   ├── const/               # 常量（API 路由、错误码等）
+│   └── app.js / app.json / app.wxss / app.ts   # 应用入口
+├── tests/
+│   ├── unit/                # Jest 单元测试
+│   ├── integration/         # 集成测试
+│   └── e2e/                 # BDD E2E（miniprogram-automator）
+├── features/                # BDD Gherkin feature 文件
+│   └── *.feature
+├── mock/                    # 模拟数据（开发环境）
+└── cloud/                   # 微信云函数 / TCB 云函数源码
+```
+
+## FR 命名空间
+
+- Prefix: `WXA-FR-NNN`
+- 范围: 微信小程序客户端行为
+
+## 特定约束
+
+### 平台约束
+- 代码包体积限制：主包 ≤ 2MB，分包 ≤ 2MB，总计 ≤ 16MB
+- 部分微信 API 仅在真机上可用（模拟器受限）
+- 登录凭证 `code` 每次调用 `wx.login()` 不同，需即时交换
+- `wx.requestPayment()` 唤起支付前需服务端签名
+- 审核周期：首次 3-7 工作日，更新 1-3 工作日（紧急可加急）
+
+### 构建时约束
+- `BACKEND_URL` 在构建时通过环境变量注入到 `app.json` 或 `service.js`
+- 微信不允许在本地调试时连接未备案的域名（开发时需在 project.config.json 配置）
+- 分包引用的静态资源需在分包目录内，不跨分包共享（如需共享用 npm package）
+
+### 安全约束
+- `openid` / `unionid` 不得明文暴露在 log 中（SEC-007）
+- 用户信息获取必须通过 `wx.getUserProfile()`（非已废弃的 `getUserInfo()`）
+- 支付相关逻辑必须在后端完成签名，禁止在前端泄露 merchant key
+- 敏感数据存储用 `wx.getStorageSync()` 配合加密，不存明文 token
+
+## 开发流程
+
+### 1. Understand（需求理解 → WXA-FR-*）
+- 在 `phases/understand/lifecycle.md` 的 WXA-FR spec template 中声明行为
+- `affects: [wxa]` 的 spec delta 必须明确页面路由、触发的微信 API、用户交互流程
+- 若 feature 跨组件，声明 `INT-FR-NNN` 关联 `BE-FR-NNN`（如登录、支付）
+
+### 2. Plan（设计 → WXA-FR-* 实现计划）
+- 页面结构设计（app.json 中的 pages 列表和分包配置）
+- API 层设计（services/ 目录下按 domain 组织）
+- 分包策略：超过 1.5MB 主包建议拆分为独立分包
+- TCB 云函数接口约定（与 BE-FR-NNN 对齐）
+
+### 3. Verify（测试 → BDD + TDD）
+- 单元测试：Jest + @tencent/wxapp-miniprogram-simtest
+- E2E：miniprogram-automator 模拟用户操作（点击、页面跳转、表单填写）
+- BDD：`pytest-bdd apps/wxa/features/`（场景覆盖登录、主页、核心交易流程）
+
+### 4. Deliver（构建 → 发布）
+- 构建：`pnpm --filter wxa build`，BACKEND_URL 注入
+- 预览：通过 `wx.uploadFile()` 上传获取 preview 二维码
+- 体验版：上传后生成体验版 QR，可分享给内部测试者
+- 提交审核：登录微信公众平台人工审核
+- 发布：审核通过后手动发布（或开启自动发布）
+
+## 微信 API 使用规范
+
+### 常用 API 分类
+
+| 类别 | API | 说明 |
+|------|-----|------|
+| 登录 | `wx.login()` | 获取临时 code，换 token 在后端 |
+| 用户信息 | `wx.getUserProfile()` | 获取加密用户数据，需用户授权 |
+| 支付 | `wx.requestPayment()` | 调起支付，前端仅唤起 |
+| 位置 | `wx.getLocation()` | GPS 定位，需声明 privacy |
+| 存储 | `wx.setStorage()` / `getStorageSync()` | 本地键值存储 |
+| 网络 | `wx.request()` | 请求 BACKEND_URL，需在合法域名列表中 |
+| 转发 | `wx.showShareMenu()` | 开启当前页面分享能力 |
+| 订阅消息 | `wx.requestSubscribeMessage()` | 一次性订阅消息推送 |
+
+### 云开发 API（TCB 集成）
+
+```javascript
+// 使用 @cloudbase/wx-server-sdk（云函数端）
+const tcb = require('@cloudbase/wx-server-sdk');
+exports.main = async (event, context) => {
+  const app = tcb.init();
+  const db = app.database();
+  // ...
+};
+
+// 前端使用 wx.cloud（微信云开发，无需额外依赖）
+wx.cloud.init({ env: 'your-env-id' });
+wx.cloud.callFunction({ name: 'login', data: {} });
+```
+
+## 分包加载策略
+
+| 策略 | 适用场景 | 配置位置 |
+|------|----------|----------|
+| 主包全量 | 功能 < 10 个页面，总体积 < 1.5MB | 默认 |
+| 普通分包 | 功能模块化，需要按需加载 | app.json `subpackages` |
+| 插件分包 | 独立业务可拔插 | app.json `plugins` |
+
+分包加载后访问路径：`/pages/subpackage-page/main`（需在 app.json 配置 root）
+
+## CI/CD
+
+```yaml
+# .github/workflows/wxa.yml（示例）
+- name: Build WXA
+  run: |
+    cd apps/wxa
+    BACKEND_URL=${{ env.BACKEND_URL }} pnpm build
+
+- name: Upload Preview
+  uses:微信官方案例/upload-miniprogram@v1
+  with:
+    appid: ${{ secrets.WX_APPID }}
+    version: ${{ env.VERSION }}
+    desc: ${{ github.event.head_commit.message }}
+
+- name: E2E Tests
+  run: pytest apps/wxa/tests/e2e/ --backend-url ${{ env.BACKEND_URL }}
+```
+
+## 与其他组件的集成
+
+- **BE-FR-NNN**：所有网络请求走 `services/` 层，URL 由 `BACKEND_URL` + route 拼接
+- **INT-FR-NNN**：跨组件行为（登录态同步、支付回调）需声明在 `contracts/` 中
+- **共享类型**：`aidlc/packages/shared/` 中的 OpenAPI 类型通过构建时生成注入
+- **Native/Desktop/Web**：各端独立构建，不共享 WXA 代码
+
+## 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` |
+| WXA UI | `phases/plan/design_system/platform_ui/wxa.md` |
+| Iconography | `phases/plan/design_system/iconography.md` |
+
+### UI 组件库
+- **默认**: Vant Weapp
+- **主题定制**: 通过 CSS 变量覆盖
+
+### 主题色
+```css
+page {
+  --primary-color: #1989fa;
+  --success-color: #07c160;
+  --danger-color: #ee0a24;
+  --warning-color: #ff976a;
+}
+```
+
+### 组件分层
+- Atom: Button, Cell, Field, Icon
+- Molecule: CellGroup, SearchBar, Card
+- Organism: NavBar, Tabbar, List
+- Template: 页面布局模板
+- Page: 业务页面

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

@@ -0,0 +1,25 @@
+# Contracts 目录说明
+
+## 三层合约体系
+
+```
+contracts/
+├── api/              ← OpenAPI 3.1 — HTTP API 合约 (已有)
+├── events/           ← AsyncAPI 3.0 — 事件合约 (已有)
+└── functions/        ← Runtime Contract — Serverless 函数接口 (新增)
+```
+
+## aidlc/contracts/api/
+HTTP API 描述，使用 OpenAPI 3.1 格式。
+每个文件对应一个 INT-FR-NNN，描述请求/响应 schema。
+
+## aidlc/contracts/events/
+事件驱动合约，使用 AsyncAPI 3.0 + CloudEvents 格式。
+描述事件的生产/消费关系。
+
+## aidlc/contracts/functions/
+Serverless 函数接口描述，Provider-agnostic。
+描述函数的触发器、资源需求、环境变量。
+部署时根据选择的 provider + compute_mode 自动映射到具体平台。
+
+模板位于 `templates/integration/runtime-contract.yaml`。

package/ai-dlc-skill/core/adaptive-flow.md

@@ -0,0 +1,107 @@
+# Adaptive Flow — 自适应流程决策
+
+AI-DLC Master Agent 根据需求复杂度自动裁剪执行阶段。
+
+## 复杂度分级
+
+| 级别 | 触发条件 | 执行阶段 |
+|------|---------|---------|
+| L1 | 单文件 bug fix，不改行为 | Verify (TDD Red→Green→Refactor) |
+| L2 | 单组件新功能，无需 INT 合约 | Understand → Verify |
+| L3 | 多组件功能，需要 INT 合约 | Understand → Plan → Verify |
+| L4 | 全栈新功能 + 部署 | Understand → Plan → Verify → Deliver |
+| L5 | 架构重构/平台迁移 | Plan → Verify |
+
+## ⚠️ 前置检查：Task Registry
+
+每次处理 intent 前必须先执行注册表检查，防止重复执行：
+
+```
+state = read(".cdh/state.json")         # ← 读 .cdh/state.json
+task_registry = state.get("task_registry", [])
+result = check(task_registry, intent)
+
+if result.found and result.pendingPhases is empty:
+    → SKIP: 返回 "该任务已在 {time} 完成。产物: {artifacts}"
+    → 不执行任何 phase
+
+if result.found and result.pendingPhases is not empty:
+    → CONTINUE: 跳过 completed phases，只执行 pending/failed phases
+    
+if not result.found:
+    → CONTINUE: 新建任务，执行完整流程
+```
+
+详细操作见 `core/task-registry.md`。
+
+## 决策流程
+
+```
+Intent 输入
+  │
+  ├─ ⚡ 1. 读 .cdh/state.json → 查 task_registry
+  │   ├─ 已完成 → 直接返回结果，不执行
+  │   └─ 部分完成 → 跳过已完成 phases
+  │
+  ├─ 2. 复杂度评估
+  │   ├─ 是否单文件/修 bug？           → L1
+  │   ├─ 是否单组件且不改合约？        → L2
+  │   ├─ 是否多组件/涉及跨组件边界？   → L3
+  │   ├─ 是否全栈/需要部署到生产？     → L4
+  │   └─ 是否重构/不新增行为/迁移？    → L5
+  │
+  └─ 3. 输出 `[Lx] Phase 列表` + 写 .cdh/state.json（current_phase + task_registry）
+```
+
+## 复杂度评估 Prompt
+
+分析用户输入时，先判断以下维度：
+
+1. **范围 (Scope)**：单文件 / 单组件 / 多组件 / 全栈
+2. **类型 (Type)**：修 bug / 新功能 / 重构 / 迁移
+3. **合约 (Contract)**：是否涉及 INT-FR、OpenAPI、AsyncAPI
+4. **部署 (Deploy)**：是否需要上线到 production
+
+输出格式：`[Lx] Phase 列表`，如 `[L3] understand → plan → verify`
+
+## 复杂度评估检查清单
+
+使用以下检查清单确定复杂度级别。回答每个问题，跟随指向的答案：
+
+### Q1: 涉及多少个文件？
+- 1 个文件 → **Q2**
+- 2-5 个文件 → **Q3**
+- 5+ 个文件 → **L3+**
+
+### Q2: 是否修改行为？
+- 修复 bug，不改行为 → **L1**
+- 改行为 / 新功能 → **Q3**
+
+### Q3: 是否涉及多个组件？
+- 否（单组件）→ **Q4**
+- 是（多组件）→ **L3+**
+
+### Q4: 是否修改公开合约（API/事件）？
+- 是 → **L3**
+- 否 → **L2**
+
+### Q5: 是否需要上线生产？
+- 是 → **L4**
+- 否 → **L2**
+
+### Q6: 是否是架构重构/平台迁移？
+- 是 → **L5**
+- 否 → **L4 或更低**
+
+### 快速决策表
+
+| 范围 | 类型 | 合约变更 | 上线生产 | 级别 |
+|------|------|---------|---------|------|
+| 单文件 | bug fix | 否 | 否 | L1 |
+| 单组件 | 新功能 | 否 | 否 | L2 |
+| 单组件 | 新功能 | 是 | 否 | L3 |
+| 多组件 | 新功能 | 否 | 否 | L3 |
+| 多组件 | 新功能 | 是 | 否 | L3 |
+| 全栈 | 新功能 | - | 是 | L4 |
+| 多组件 | 重构 | - | - | L5 |
+| 全栈 | 迁移 | - | - | L5 |

package/ai-dlc-skill/core/security.md

@@ -0,0 +1,29 @@
+# Security Rules (SEC-*)
+
+## SEC-001: Secrets Management
+**Severity:** MUST
+Secrets MUST be retrieved from secure storage, never hardcoded or logged.
+
+## SEC-002: Input Validation
+**Severity:** MUST
+All user input MUST be validated before processing: type, length, format, range.
+
+## SEC-003: SQL Injection Prevention
+**Severity:** MUST
+All database queries MUST use parameterized statements.
+
+## SEC-004: CORS Configuration
+**Severity:** MUST
+CORS headers MUST be explicitly configured. Wildcard origins prohibited in production.
+
+## SEC-005: Rate Limiting
+**Severity:** MUST
+Public endpoints require rate limiting: 100 req/min unauthenticated, 1000 req/min authenticated.
+
+## SEC-006: HTTPS Only
+**Severity:** MUST
+All production traffic MUST use HTTPS. HTTP redirects to HTTPS.
+
+## SEC-007: Audit Logging
+**Severity:** MUST
+Security events MUST be logged with timestamps and actor identity.

package/ai-dlc-skill/core/task-registry.md

@@ -0,0 +1,153 @@
+# Task Registry — 任务状态注册表
+
+任务状态持久化机制，防止相同 intent 重复执行已完成的 phase。
+Registry 作为 `task_registry` 数组存储在 `.cdh/state.json` 中。
+
+## 存储位置
+
+`.cdh/state.json` — 与 sidebar 状态共用同一文件。
+
+## 数据结构
+
+```json
+{
+  "current_phase": "understand",
+  "completed_phases": ["understand", "plan"],
+  "gate_results": {},
+  "fingerprint": "abc123...",
+  "task_registry": [
+    {
+      "fingerprint": "24-char-hash",
+      "intent": "用户输入意图摘要",
+      "status": "completed",
+      "created_at": "2024-01-01T12:00:00Z",
+      "updated_at": "2024-01-01T12:30:00Z",
+      "result": "任务完成描述"
+    }
+  ]
+}
+```
+
+**Schema 字段说明：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `fingerprint` | string (24 chars) | 是 | 任务唯一标识，基于 intent 生成 |
+| `intent` | string | 是 | 用户意图摘要 |
+| `status` | enum | 是 | `pending`/`in_progress`/`completed`/`failed` |
+| `created_at` | date-time | 是 | 任务创建时间 |
+| `updated_at` | date-time | 是 | 任务最后更新时间 |
+| `result` | string | 否 | 任务执行结果描述 |
+
+**顶层字段说明：**
+
+| 字段 | 说明 |
+|------|------|
+| `current_phase` | 当前正在执行的 phase |
+| `completed_phases` | 已完成的 phases 列表 |
+| `gate_results` | 各 gate 的执行结果 |
+
+## 操作方式
+
+**注意：使用 CDH 的 `save_state_atomic()` API 以避免竞态条件。**
+
+Master Agent 应通过 CDH API 操作状态，而不是直接 bash 读写：
+
+```python
+# 读取
+from cdh.project_loader import CdhProjectLoader
+state = CdhProjectLoader.load_project_state(cdh_dir)
+
+# 写入（原子操作，防止竞态）
+success = CdhProjectLoader.save_state_atomic(cdh_dir, state)
+```
+
+如果必须使用 bash：
+
+```bash
+# 读取
+cat .cdh/state.json
+
+# 写入（使用临时文件 + 原子替换）
+python -c "
+import json, tempfile, os
+state = json.load(open('.cdh/state.json'))
+# ... 修改 state ...
+# 原子写入
+tmp = tempfile.NamedTemporaryFile(mode='w', delete=False, suffix='.json')
+json.dump(state, tmp, ensure_ascii=False, indent=2)
+tmp.close()
+os.replace(tmp.name, '.cdh/state.json')
+"
+```
+
+## Master Agent 执行流程
+
+```
+Intent 输入
+  │
+  ├─ 读 .cdh/state.json → 检查 task_registry 匹配
+  │   ├─ found + status=completed → SKIP
+  │   ├─ found + status=in_progress → 续跑
+  │   └─ not found → 创建新 task 条目
+  │
+  ├─ 复杂度评估 → 选择 phases
+  ├─ 写 .cdh/state.json: current_phase=首个phase, task_registry 新增
+  │
+  ├─ For each phase:
+  │   ├─ TodoClear
+  │   ├─ Task(agent_type="ai-dlc-{phase}", prompt=...)
+  │   ├─ 收集结果 → gate 检查 → AskUser 确认
+  │   └─ 写 .cdh/state.json: 追加 completed_phases, 更新 current_phase
+  │
+  └─ All done → task_registry[].status = "completed"
+```
+
+## 状态机
+
+```
+                  ┌─────────┐
+                  │ pending │
+                  └────┬────┘
+                       │ 开始执行
+                       ▼
+                  ┌─────────┐
+                  │in_progress │
+                  └────┬────┘
+                       │ 所有 phases 完成
+                       ▼
+           ┌────────────────────────┐
+           │      completed        │
+           └────────────────────────┘
+                       │
+                       │ 失败
+                       ▼
+                  ┌─────────┐
+                  │ failed  │
+                  └─────────┘
+```
+
+## Task Status
+
+| Status | 含义 | 下一步 |
+|--------|------|--------|
+| `pending` | 未开始 | 开始执行 |
+| `in_progress` | 执行中 | 等待完成 |
+| `completed` | 已完成 | 跳过 |
+| `failed` | 失败 | 重试或 abort |
+
+## Phase 完成追踪
+
+Phase 级别的完成状态通过顶层 `completed_phases` 数组追踪：
+
+```json
+{
+  "current_phase": "verify",
+  "completed_phases": ["understand", "plan"]
+}
+```
+
+这意味着：
+- `completed_phases` 包含已完成的 phases
+- `current_phase` 是当前正在执行的 phase
+- 不在 `completed_phases` 中且不等于 `current_phase` 的 phase 为 pending

package/ai-dlc-skill/cross-tool/README.md

@@ -0,0 +1,20 @@
+# Cross-Tool Export
+
+Each subdirectory contains a script that exports AI-DLC rules to a specific AI coding tool.
+
+| Tool | Export Script | Output |
+|------|---------------|--------|
+| OpenCode | `opencode/export.sh` | `.opencode/skills/ai-dlc-skill/` symlink |
+| Cursor | `cursor/export.sh` | `.cursor/rules/ai-dlc-core.mdc` |
+| Cline | `cline/export.sh` | `.clinerules` |
+| Copilot | `copilot/export.sh` | `.github/copilot-instructions.md` |
+
+Usage:
+
+```bash
+# Export to all tools
+./cross-tool/opencode/export.sh
+./cross-tool/cursor/export.sh
+./cross-tool/cline/export.sh
+./cross-tool/copilot/export.sh
+```

package/ai-dlc-skill/cross-tool/cline/export.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Generates .clinerules from ai-dlc-skill/SKILL.md
+
+set -euo pipefail
+
+CANONICAL_SKILL_DIR="${HOME}/.cdh/skills/ai-dlc-skill"
+DEV_SKILL_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+
+if [ -d "$CANONICAL_SKILL_DIR" ]; then
+    SKILL_DIR="$CANONICAL_SKILL_DIR"
+else
+    SKILL_DIR="$DEV_SKILL_DIR"
+fi
+
+SKILL_FILE="$SKILL_DIR/SKILL.md"
+PROJECT_ROOT="$(cd "$DEV_SKILL_DIR/.." && pwd)"
+OUTPUT_FILE="$PROJECT_ROOT/.clinerules"
+
+awk '
+  BEGIN { count=0; }
+  /^---$/ { count++; next; }
+  count >= 2 { print }
+' "$SKILL_FILE" > "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" << 'RULES'
+
+## Project Rules
+
+1. Intent → Spec (EARS) → BDD → Design (DAG) → TDD Red-Green-Refactor → Deploy
+2. Contract-first for cross-component changes (`aidlc/contracts/`)
+3. FR namespaces: NATIVE|DESKTOP|WEB|BE|WXA|MYA|TTA (apps/) + INT (aidlc/contracts/)
+4. Quality gates: coverage ≥80%, BDD 100%, 0 vulns, no TODO, backward-compat contracts
+5. Cross-stack e2e mandatory for changes affecting ≥2 components
+6. Never commit secrets; never force-push to main/master
+7. Chinese for user communication, English for code
+RULES
+
+echo "Generated $OUTPUT_FILE from $SKILL_DIR/SKILL.md"

package/ai-dlc-skill/cross-tool/copilot/export.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Generates .github/copilot-instructions.md from ai-dlc-skill/SKILL.md
+
+set -euo pipefail
+
+CANONICAL_SKILL_DIR="${HOME}/.cdh/skills/ai-dlc-skill"
+DEV_SKILL_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+
+if [ -d "$CANONICAL_SKILL_DIR" ]; then
+    SKILL_DIR="$CANONICAL_SKILL_DIR"
+else
+    SKILL_DIR="$DEV_SKILL_DIR"
+fi
+
+SKILL_FILE="$SKILL_DIR/SKILL.md"
+PROJECT_ROOT="$(cd "$DEV_SKILL_DIR/.." && pwd)"
+OUTPUT_DIR="$PROJECT_ROOT/.github"
+OUTPUT_FILE="$OUTPUT_DIR/copilot-instructions.md"
+
+mkdir -p "$OUTPUT_DIR"
+
+awk '
+  BEGIN { count=0; }
+  /^---$/ { count++; next; }
+  count >= 2 { print }
+' "$SKILL_FILE" > "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" << 'RULES'
+
+## Project Rules
+
+1. Intent → Spec (EARS) → BDD → Design (DAG) → TDD Red-Green-Refactor → Deploy
+2. Contract-first for cross-component changes (`aidlc/contracts/`)
+3. FR namespaces: NATIVE|DESKTOP|WEB|BE|WXA|MYA|TTA (apps/) + INT (aidlc/contracts/)
+4. Quality gates: coverage ≥80%, BDD 100%, 0 vulns, no TODO, backward-compat contracts
+5. Cross-stack e2e mandatory for changes affecting ≥2 components
+6. Never commit secrets; never force-push to main/master
+7. Chinese for user communication, English for code
+RULES
+
+echo "Generated $OUTPUT_FILE from $SKILL_DIR/SKILL.md"

package/ai-dlc-skill/cross-tool/cursor/export.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Generates .cursor/rules/ai-dlc-core.mdc from ai-dlc-skill/SKILL.md
+
+set -euo pipefail
+
+CANONICAL_SKILL_DIR="${HOME}/.cdh/skills/ai-dlc-skill"
+DEV_SKILL_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+PROJECT_ROOT="$(cd "$DEV_SKILL_DIR/.." && pwd)"
+
+if [ -d "$CANONICAL_SKILL_DIR" ]; then
+    SKILL_DIR="$CANONICAL_SKILL_DIR"
+else
+    SKILL_DIR="$DEV_SKILL_DIR"
+fi
+
+SKILL_FILE="$SKILL_DIR/SKILL.md"
+OUTPUT_DIR="$PROJECT_ROOT/.cursor/rules"
+OUTPUT_FILE="$OUTPUT_DIR/ai-dlc-core.mdc"
+
+mkdir -p "$OUTPUT_DIR"
+
+cat > "$OUTPUT_FILE" << 'MDCFRONT'
+---
+description: AI-DLC Core Lifecycle Rules
+globs: ["*"]
+---
+
+MDCFRONT
+
+awk '
+  BEGIN { found=0; count=0; }
+  /^---$/ { count++; if (count == 1) next; if (count == 2) { found=1; next; } }
+  found { print }
+' "$SKILL_FILE" >> "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" << 'RULES'
+<!-- ═══════════════════════════════════════════════════════════
+     Project Rules
+     ═══════════════════════════════════════════════════════════ -->
+
+## Project Rules
+
+1. Intent → Spec (EARS) → BDD → Design (DAG) → TDD Red-Green-Refactor → Deploy
+2. Contract-first for cross-component changes (`aidlc/contracts/`)
+3. FR namespaces: NATIVE|DESKTOP|WEB|BE|WXA|MYA|TTA (apps/) + INT (aidlc/contracts/)
+4. Quality gates: coverage ≥80%, BDD 100%, 0 vulns, no TODO, backward-compat contracts
+5. Cross-stack e2e mandatory for changes affecting ≥2 components
+6. Never commit secrets; never force-push to main/master
+7. Chinese for user communication, English for code
+8. Run lint/typecheck/test after non-trivial edits
+RULES
+
+echo "Generated $OUTPUT_FILE from $SKILL_DIR/SKILL.md"