Cloudflare 上 AI-agent 部署的候選 conformance profile｜A candidate conformance profile for AI-agent deployment of small, self-owned cloud services.
Status: v0.3.1 — 六件套齊備＋三環閉環（CON-8 建置閘／AGT 修復邊界／CON-9 宣告完整性）；Evidence Pack schema 0.4.0（凍結於 0.1.0，其後皆 additive）；37 runs 實跑回饋收斂至 issues #1-#13
定位（2026-08-05 依三方審查下修）：本規格不宣稱是一套新標準。它是把既有元件——AGENTS.md（agent 指示慣例）、JSON Schema、平台自己的 wrangler.jsonc 資源宣告——組成的候選 conformance profile：在其上補一層「執行期驗收＋移除程序＋更新義務」的機械可檢查產物。跨平台互通、獨立實作相容、社群共識三者皆未證明，故不使用「標準」定位。與 TOSCA／CNAB／Helm 等既有規範的關係尚在核實中（spec#18）。
定義「一個小型開源專案如何被安全地部署成使用者自己帳號裡的 serverless 服務（GitHub＋Cloudflare 免費額度）」：部署前判定、部署驗收、長期維護、以及可稽核的驗證證據。
目前有證據支持的效果，只有一項（37 runs，2026-08-05 盤點）：契約使第三方能在不讀原始碼、不執行 agent 的情況下重現移除程序並留下可稽核證據。契約沒有提高初始部署成功率（11/12 vs 12/12），也沒有明顯縮短耗時（中位 14 分 vs 16 分）。更大的宣稱請勿引用本規格。
核心原則：
- 沒有 validator 的條款不進標準——寫得出檢查器的才是規範，寫不出的是建議。每條 requirement 有唯一 ID 且可判定；每份 spec 文件必含 test_matrix 章節（requirement × 測試類型 × 落點），矩陣即 conformance 實作的 RED 清單
- Agent 是導遊不是裁判——引導用跨 CLI 的 AGENTS.md，每一關的綠燈由機械驗證判定
- 統計對象是專案，永遠不是使用者——範本與已驗證專案不得包含任何遙測程式碼
- wrangler 設定仍是資源宣告的唯一真相源——契約檔（
.smallgreen/）只補判定、驗收、維護三層
| # | 元件 | 文件 | ID 前綴 |
|---|---|---|---|
| 1 | Profile 判定規則 | profiles/small-app-profile.md／profiles/pipeline-profile.md＋free-tier-allowlist.yaml | SAP／PIP |
| 2 | 契約檔 schema（.smallgreen/ 三件） |
schemas/contract.md＋profile／acceptance／maintenance | CON |
| 3 | 服務卡 schema（含低碳欄位組） | schemas/service-card.md＋service-card.schema.json | SVC |
| 4 | 三級驗證＋Evidence Pack | verification/levels.md＋evidence-pack.md＋evidence-pack.schema.json | VER／EP |
| 5 | 裁判層 MCP 介面規格（12 工具） | judge/mcp-interface.md | JDG |
| 6 | 部署狀態機 | state-machine/deployment-state-machine.md | SM |
| — | 資料治理與版本政策 | GOVERNANCE.md | GOV |
三級驗證：Discovered → Community Verified → SmallGreen Ready
三條套用路徑：A 新專案用 small-service-template／B 既有專案由 publish agent 生成契約檔 PR／C 外部專案建適配 repo（UPSTREAM.md 鎖 commit，徽章掛 registry 不掛上游）。
conformance——檢查腳本＋reusable GitHub Actions workflow：契約 schema、免費層允許清單、secrets 掃描、secrets manifest 一致性、migration 空庫重放、本地 smoke。各檔 test_matrix 的「conformance CI」落點由它實現small-service-template——起手式範本，用它建的專案天生合規（其 CI 即 conformance 的活體驗證）
registry— 已驗證服務目錄與服務卡conformance— conformance 檢查腳本與 reusable workflowsmall-service-template— 天生合規的起手式範本
本標準將 GSF 三活動落為可檢核屬性：能源效率（scale-to-zero）、碳感知（Green Compute）、硬體效率（共享多租戶）；量測對齊 SCI（ISO/IEC 21031:2024）。驗證統計以 CC 授權公開為 SmallGreen Evidence Dataset（見 GOVERNANCE.md）。
發起：Alan Chen（cooperation.tw）。License：規格文件 CC-BY-4.0／程式碼與機器可讀資產 Apache-2.0（見 LICENSE.md，2026-07-30 定案）。