1

_DEL/miniprogram-dev/README.md

@@ -0,0 +1,74 @@
+# 小程序前端页面开发与原型迁移指南
+
+> 操作文档已迁移至 Kiro Power `miniprogram-h5-conversion`，通过关键词自动激活。
+> 本目录仅保留实时更新的仓库驻留文件（进度、经验、页面结构等）。
+
+---
+
+## Power 使用方式
+
+操作文档（调度手册、子代理手册、转换规则、WXSS 规范、CSS 风险清单、Power 集成指南）已打包为 Kiro Power：
+
+- Power 名称：`miniprogram-h5-conversion`
+- 激活方式：对话中提及"小程序页面"、"H5转换"、"wxml"、"wxss"、"rpx"等关键词时自动激活
+- 手动激活：`kiroPowers action="activate" powerName="miniprogram-h5-conversion"`
+- 查看 steering 列表：激活后在返回的 `steeringFiles` 中选择需要的文件
+
+Power 包含 12 个 steering 文件，按职能分三层：
+
+| 层 | 文件 | 说明 |
+|----|------|------|
+| 调度层 | `batch-auto.md` | 89 单元批量编排 |
+| 调度层 | `user-guided.md` | 半自动模式 |
+| 调度层 | `new-page.md` | 新页面开发 |
+| 行动层 | `screenshot.md` | 截图代理手册 |
+| 行动层 | `audit.md` | 审计代理手册 |
+| 行动层 | `fix.md` | 修正代理手册 |
+| 行动层 | `verify.md` | 验证代理手册 |
+| 行动层 | `page-dev.md` | 页面开发代理手册 |
+| 参考层 | `conversion-rules.md` | 核心转换规则 |
+| 参考层 | `wxss-rules.md` | WXSS 标准值速查 |
+| 参考层 | `css-risk.md` | CSS 风险特性清单 |
+| 参考层 | `power-integration.md` | Power 调用规范 |
+
+---
+
+## 仓库驻留文件（实时更新，不在 Power 内）
+
+```
+docs/miniprogram-dev/
+├── README.md                          ← 你在这里
+├── 03-reference/
+│   ├── page-structure-map.md          # 各页面特殊结构速查（新增页面时更新）
+│   └── benchmark-history.md           # 基准测试历史记录
+├── 04-audit/
+│   ├── PROGRESS.md                    # 89 单元迁移进度（每次会话必读）
+│   └── CHANGELOG.md                   # 文档体系版本变更
+└── 05-lessons/
+    ├── pitfalls.md                    # 踩坑速查（实战经验，持续更新）
+    └── convergence-patterns.md        # 收敛模式 + 不可消除差异白名单
+```
+
+---
+
+## Power 依赖清单
+
+| Power | 用途 |
+|-------|------|
+| `wechat-miniprogram` | 小程序开发规范（WXML/WXSS/API/TDesign） |
+| `pixel-audit` | 像素间距测量 + rpx 换算 |
+| `playwright` | H5 端截图 |
+| `weixin-devtools` | MP 端截图 + 页面操作 |
+
+---
+
+## 关联资源
+
+| 资源 | 路径 |
+|------|------|
+| H5 原型页面 | `docs/h5_ui/pages/*.html` |
+| 设计 Token | `docs/h5_ui/design-tokens.json` |
+| 图标映射表 | `docs/h5_ui/icon-mapping.md` |
+| 截图产物 | `docs/h5_ui/compare/<page>/` |
+| 小程序源码 | `apps/miniprogram/miniprogram/pages/` |
+| 辅助脚本 | `scripts/ops/measure_gaps.py`、`scripts/ops/anchor_compare.py` |