仓库与贡献
按你要修改的能力选择仓库。拆分保留现有 npm 包名；Git 仓库的位置与 npm 包版本是两件事。
| 仓库 | 负责内容 | 适合的修改 |
|---|---|---|
| htyf-cli | CLI、RN 与 Godot 模板 | 初始化、打包、真机调试、非交互命令 |
| htyf-taro | Taro 平台插件、组件、运行时、样式工具、模板与示例 | htyf 构建、Taro API 与组件适配 |
| htyf-skills | 迁移 Skill、规则、参考流程和安装器 | 全量迁移、增量同步、能力边界与验收规则 |
使用者如何选择
- 创建新项目：使用
@htyf-mp/cli，参照快速开始。 - 开发 Taro 项目：使用 Taro 模板和配套的
@htyf-mp/taro-*包。 - 迁移已有代码：额外安装 htyf-skills，参照AI 迁移教程。
- 查看宿主 API：参照 JS SDK 指南。
开发者如何验证
CLI 在 packages/cli；Taro 模板在 templates/taro，运行示例在 examples/taro；技能入口在 skills/htyf-migration/SKILL.md。
CLI 与 Taro 仓库分别安装依赖、运行测试和包归档检查。Taro 的内部包通过 workspace 关联，对独立 CLI 使用发布版本；模板按发布版本安装，不依赖开发者电脑上的目录。Skills 安装器只需要 Node.js。
源码与发布版本
仓库拆分不会自动发布新的 npm 版本。旧 CLI 可能仍从旧仓库读取 Taro 模板。请先检查 --help 和所用版本；需要最新拆分逻辑时，使用当前 CLI 源码入口，待新版本发布后再更新项目依赖。
提交问题时附上仓库、包版本、最小复现、命令与日志。迁移问题还应包含源类型、目标模板及未通过的功能清单，便于区分规则问题、编译问题和宿主能力缺口。