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日 定案)。