write-appcipe
Installation
SKILL.md
撰寫 appcipe.yml
appcipe.yml 是 Chefer 的「食譜」:描述一或多個 Docker/OCI 映像 + 執行參數,
chefer build 會把它們打包成單一執行檔(免裝 Docker/容器引擎,雙擊即跑)。
權威驗證規則在 crates/appcipe-spec/src/validate.rs;完整契約在 docs/DESIGN.md §3/§6;
有註解的範例見 examples/appcipe.yml、可運作的多服務範例見 examples/demo/。
改完一定要 cargo run -p chefer-cli -- check <appcipe.yml> 驗證(會一次列出所有錯誤)。
整體流程(先講給使用者聽)
docker build / docker pull → docker save -o x.tar <image> # 取得 image tar
寫 appcipe.yml(image 指向那些 tar)
chefer build appcipe.yml --out dist # 產出單檔
image 來源可為 tar(docker save/OCI archive)、registry ref(釘版 tag 或 @sha256;公開 image 匿名拉取,私有 registry 用 docker login 的明文 auths 憑證或 CHEFER_REGISTRY_AUTH=user:pass——外部 credential helper 不支援)或 Dockerfile(打包機需有 docker/podman/nerdctl)。