
分發(fā)注冊(cè)表方法注冊(cè)表元數(shù)據(jù)將本地技能目錄轉(zhuǎn)變?yōu)榭砂惭b、可審查的包記錄。何時(shí)使用對(duì)庫(kù)、受治理、團(tuán)隊(duì)分發(fā)或升級(jí)敏感的技能使用注冊(cè)表審計(jì)。腳手架技能在復(fù)用成為現(xiàn)實(shí)之前可以跳過(guò)。必需證據(jù)包名稱、版本、所有者、成熟度、審查節(jié)奏和許可證Skill IR 來(lái)源和模式版本信任級(jí)別和包 SHA256構(gòu)建 zip 分發(fā)時(shí)的包驗(yàn)證狀態(tài)和歸檔 SHA256當(dāng)歸檔旨在本地或團(tuán)隊(duì)安裝時(shí)的安裝模擬狀態(tài)存在本地遙測(cè)時(shí)的采用/漂移聚合狀態(tài)目標(biāo)兼容性矩陣存在先前包基線時(shí)的升級(jí)差異、推薦版本提升和破壞性變更說(shuō)明指向概覽、Review Studio、信任報(bào)告、一致性矩陣、包驗(yàn)證、安裝模擬、采用漂移證據(jù)和審查豁免的鏈接發(fā)布規(guī)則當(dāng)注冊(cè)表審計(jì)報(bào)告缺少版本、哈希、所有者、審查節(jié)奏、許可證、有效的 Skill IR 或聲明目標(biāo)的兼容性通過(guò)時(shí)不要發(fā)布團(tuán)隊(duì)包。對(duì)于可安裝歸檔首先構(gòu)建分發(fā)并運(yùn)行包驗(yàn)證python3 scripts/yao.py package.--platformopenai--platformclaude--platformgeneric--platformvscode --output-dir dist--zippython3 scripts/yao.py package-verify.--package-dir dist --require-zip python3 scripts/yao.py install-simulate.--package-dir dist python3 scripts/yao.py registry-audit.python3 scripts/yao.py upgrade-check.--previous-package-json registry/examples/yao-meta-skill-1.0.0.json當(dāng)包驗(yàn)證報(bào)告不安全的 zip 路徑、缺失目標(biāo)適配器、缺失包清單、注冊(cè)表元數(shù)據(jù)不匹配或不可讀的歸檔內(nèi)容時(shí)不要聲稱歸檔就緒。當(dāng)安裝模擬無(wú)法將歸檔解壓到臨時(shí)技能根目錄、加載SKILL.mdfrontmatter、讀取manifest.json、讀取agents/interface.yaml、找到概覽和 Review Studio 報(bào)告或加載每個(gè)生成的適配器時(shí)不要聲稱安裝就緒。在同一個(gè)包通過(guò)安裝預(yù)檢之前不要從源同步本地或活躍安裝。scripts/sync_local_install.py必須針對(duì)配置的包目錄運(yùn)行安裝模擬并且當(dāng)任何目標(biāo)/能力組合缺少活躍權(quán)限批準(zhǔn)或目標(biāo)特定執(zhí)行證據(jù)時(shí)在復(fù)制文件之前失敗。--skip-install-preflight僅用于隔離診斷不用于發(fā)布或活躍安裝。不要在分發(fā)包中包含原始reports/telemetry_events.jsonl。僅包含聚合的采用漂移報(bào)告并且當(dāng)遙測(cè)包含原始提示、輸出、轉(zhuǎn)錄稿、筆記或消息時(shí)阻止發(fā)布審查。審查豁免證據(jù)可以作為reports/review_waivers.md/json分發(fā)因?yàn)樗莾H元數(shù)據(jù)的審查者問(wèn)責(zé)。不要在豁免理由中存儲(chǔ)原始提示、輸出、轉(zhuǎn)錄稿、憑據(jù)或私有客戶細(xì)節(jié)。當(dāng)升級(jí)檢查報(bào)告版本提升不足、無(wú)主版本提升的目標(biāo)移除、無(wú)主版本提升的兼容性回歸、包名稱變更或無(wú)效的 semver 時(shí)不要聲稱升級(jí)就緒。在審查者證據(jù)包中包含reports/upgrade_check.md使發(fā)布說(shuō)明和遷移指導(dǎo)與確切的注冊(cè)表差異綁定。審查者門(mén)禁審查者應(yīng)能回答正在安裝哪個(gè)包版本誰(shuí)擁有這個(gè)包哪些目標(biāo)兼容哪個(gè)校驗(yàn)和標(biāo)識(shí)被審查的包內(nèi)容哪些報(bào)告證明信任和運(yùn)行時(shí)就緒可安裝歸檔是否已驗(yàn)證哪個(gè)校驗(yàn)和標(biāo)識(shí)它歸檔是否在臨時(shí)本地技能根目錄中進(jìn)行了安裝模擬本地或活躍安裝同步是否保留了該預(yù)檢和安裝者權(quán)限門(mén)禁自上一個(gè)包以來(lái)發(fā)生了什么變化聲明的版本提升是否與推薦提升匹配采用和漂移信號(hào)是否被總結(jié)而沒(méi)有打包原始本地遙測(cè)