feat: add skill init/check and isolate builder makefile

Give ack, builder, and deployer an explicit init/check mode that reports
missing project config instead of failing mid-work. Point builder at
makefile.builder so its contract targets do not collide with an existing
Makefile.

skills/builder/README.md

@@ -6,19 +6,25 @@
 
 ## 什么时候使用
 
+- "用 builder 初始化这个项目"
 - "帮我构建这个项目的 DEB / Docker 镜像"
 - "把 1.2.3 发布到包仓库 / 镜像仓库"
-- "检查这个项目的 Makefile 是否符合 builder 契约"
+- "检查这个项目的 makefile.builder 是否符合 builder 契约"
 - "看看项目现在的发布流程"
 
 只构建不上传时明确说明即可；上传永远需要你显式授权。
 
 ## 项目接入契约
 
-1. 用 create-makefile skill 生成或修正 Makefile（目标 `help/build/clean/version`
-   + 条件 `deb/docker/push*`，变量 `ARCH/VERSION/DIST_DIR/PROJECT_NAME`）。
+对新项目说「用 builder 初始化」。Agent 会探测轨道、按
+`templates/makefile.builder` 写出项目根 `makefile.builder`，并列出缺的发布配置。
+不改用户已有的 `Makefile`。
+
+1. `makefile.builder` 目标：`help/build/clean/version` + 条件 `deb/docker/push*`，
+   变量 `ARCH/VERSION/DIST_DIR/PROJECT_NAME`。
    `VERSION` 通过 `include <builder>/scripts/version.mk` 从 Git 推导。
-2. 运行 `python3 -I -S <builder>/scripts/check.py .` 直到全部 PASS。
+2. 运行 `python3 -I -S <builder>/scripts/check.py . --ready` 直到构建项 PASS。
+   缺发布键只挡住上传，不挡住构建。
 3. 在项目根 `.env` 配置发布环境变量：
 
 ```text
@@ -28,7 +34,9 @@ DEB_TOKEN=<token>            # 只放 .env 或密钥系统，不进 git
 DOCKER_REGISTRY=registry.example.com
 ```
 
-4. 日常发布就是两条命令：`make deb && make push-deb`、`make push-docker`。
+4. 日常发布就是两条命令：
+   `make -f makefile.builder deb && make -f makefile.builder push-deb`、
+   `make -f makefile.builder push-docker`。
 
 ## 版本号
 
@@ -40,7 +48,7 @@ DOCKER_REGISTRY=registry.example.com
 | --- | --- |
 | manage-release | 选定下一个正式 SemVer，打 annotated tag `vX.Y.Z` |
 | builder | 读 HEAD：落在稳定 tag 上则打正式产物，否则打测试产物 |
-| `make version` | 输出一行规范版本（无 `v` 前缀），DEB / Docker 都从它渲染 |
+| `make -f makefile.builder version` | 输出一行规范版本（无 `v` 前缀），DEB / Docker 都从它渲染 |
 
 **不要**用 `git tag \| sort -V \| tail -1` 取全仓库最大号，也不要把
 `git describe --dirty` 的原始字符串写进 DEB 或镜像 tag。
@@ -83,7 +91,8 @@ detached HEAD 用 `detached`，CI 可注入 `BUILD_BRANCH` / `CI_COMMIT_BRANCH`
 ## 使用示例
 
 ```text
-用 builder 检查这个项目的 Makefile 是否符合契约。
+用 builder 初始化这个项目。
+用 builder 检查这个项目的 makefile.builder 是否符合契约。
 用 builder 构建当前版本的 DEB 和镜像，先不要上传。
 用 builder 把当前 commit 的产物发布到项目已配置的仓库。
 用 builder 发布多平台 linux/amd64,linux/arm64 镜像。
@@ -93,9 +102,10 @@ detached HEAD 用 `detached`，CI 可注入 `BUILD_BRANCH` / `CI_COMMIT_BRANCH`
 
 | 脚本 | 用途 |
 |------|------|
-| `scripts/check.py` | 校验项目 Makefile 是否符合契约（`--build` 实构核对产物） |
+| `scripts/check.py` | 校验契约（`--ready` 含工具链与发布键名，`--build` 实构核对产物） |
+| `templates/makefile.builder` | 初始化用的契约文件骨架，拷到项目根 |
 | `scripts/version.sh` | 从 Git 祖先稳定 tag 推导规范版本 / Docker tag |
-| `scripts/version.mk` | 项目 Makefile `include`，设置 `VERSION` 与 `IMAGE_TAG` |
+| `scripts/version.mk` | `makefile.builder` `include`，设置 `VERSION` 与 `IMAGE_TAG` |
 | `scripts/upload_deb.sh` | 上传 `.deb` 到 HTTP 包仓库（multipart package/token/repository_name） |
 | `scripts/publish_docker.sh` | buildx 构建 + 推送镜像，远端 digest 验证 |
 | `scripts/verify_deb.sh` | 核对包元数据、内容与 SHA-256 |