用途:把指定项目 $1 登记到 monorepo 基础设施中,适合 laurigates/mcu-tinkering-lab 内新增 ESP-IDF/ESPHome 项目后的规范化接入。
主要能力与流程:
- 验证项目存在:检查 packages/<domain>/$1/ 目录及基础结构,包括 CMakeLists.txt 或 ESPHome .yaml、main/ 目录(ESP-IDF 项目)、justfile。
- 登记到根 justfile:若尚未存在,按字母顺序在现有 mod 声明中插入 mod project-name 'packages/<domain>/project-name',命名遵循小写连字符(lowercase-kebab-case)约定。
- 校验 CI 构建工作流:每个 ESP32 项目对应 .github/workflows/build-<project>.yml,调用可复用的 _ci-build-esp32.yml;确认该文件存在,或标注需要创建(可参考 build-melody-detector.yml),且未经确认不自动修改工作流文件。
- 检查标准文件清单:逐一报告 justfile、CMakeLists.txt、sdkconfig.defaults、version.txt、README.md、CLAUDE.md、WIRING.md、.gitignore(是否由根目录覆盖)的存在或缺失状态。
- 建议后续技能:缺失 README 用 /project-readme $1,缺失 CLAUDE.md 用 /project-claude-md $1,缺失 WIRING.md 用 /wiring-doc $1,缺失 sdkconfig.defaults 用 /sdkconfig-audit $1,缺少凭据配置用 /credential-setup $1。
输出格式:以“Project Registration: <project-name>”开头,包含 Registration(根 justfile 是否已添加、CI matrix 是否存在或需手动添加)、File Inventory 表格及 Suggested Next Steps。
限制:需确认后才编辑工作流文件;具体领域目录、CI 触发条件及项目命名细节以仓库实际约定为准,资料未提供的部分暂未提供。