Project Steward
角色與路由
Project Steward 保存跨專案可複用的治理方法。專案自己的產品決定、架構事實和長期約束留在專案現有真源中；用戶和機器的可變工具事實留在專案與 Skill 之外的環境檔案中。
先按用戶要得到的結果選擇主路徑；同一請求中的獨立結果分別建帳：
- 歷史對話、糾正、完整實施過程或目標 Skill 職能邊界：對話學習與自我進化。
- 功能、重構、遷移或跨層改動開始前消除返工：改動前預防。
- 缺陷、半遷移、重複修補、真實鏈路失效，或內聚、耦合、重複、上帝模組檢查：根因治理。
- 檢查、接入或修復專案與外部 CLI、執行工具或協議的相容關係：外部工具相容性。
- 看懂倉庫、目錄或原始碼套件的用途、架構和能力，或研究參考專案：專案研究與講解。
- 盤點或整理專案目錄，判斷真實使用、生成狀態、忽略、移動、歸檔與刪除邊界：專案目錄治理。
- 建立、採用、升級或檢查專案模板：專案基線與模板。
- 把穩定預設寫入模板：模板演進。
- 定義、審查、重建或實施產品體驗與介面：產品體驗與介面治理。
- 審計、重寫 README 或製作 GitHub 主頁視覺：README 與主頁。
- 治理專案日誌、LLM 記錄、長期記憶、TTS 或日誌查看結果：人性化日誌。
- 初始化 Git、建立倉庫、提交、推送、改變可見性或驗證遠端：倉庫建立與發布。
- 選擇、應用或批量治理許可證與第三方授權：許可證治理。
- 建立或消費用戶環境檔案，檢查工具、快取、SDK、終端或長任務：用戶環境檔案與執行環境。
- 按實施計畫逐項核對完成度，或全面檢查、判斷專案健康狀況和排列專案級風險：專案綜合審計。
只點名本 Skill 時按現有材料選擇最匹配路徑；材料不足時給出一個貼近上下文的直接請求範例並停下。
主路徑選定後，在任何專案寫入或專項實施前建立路由帳本：用戶最終結果、主路徑、固定必讀方法、條件專項及其觸發證據、動作門檻、正式消費者、驗收和停止位置。固定必讀方法不能因為局部修改看起來明顯而跳過；條件專項只有取得適用證據才疊加。同一請求後來增加驗收項時更新原帳本，不用最新症狀取代仍有效的範圍。
共同邊界
- 普通業務功能仍由當前開發任務負責；用戶只要求解釋單條報錯、單個函式或局部行為時，在回答該結果後停止，不升級為專案級改造。只有請求本身要求預防、治理、遷移、自我進化或專案級結果時才進入相應路徑。
- 選擇路徑後立即凍結範圍、寫入權限和停止位置。檢查、審計、診斷、評估、分析、復盤或報告預設唯讀；同一請求明確要求修復、治理、實施、修改、更新或自我進化時才獲得相應寫入權限。
- 用戶提供原始碼歸檔並要求看懂、審計或研究專案，或只點名本 Skill 並附上原始碼歸檔時，解壓是進入唯讀研究所需的材料準備，不是專案正式寫入。直接按「專案研究與講解」確定目標根，運行既有指令碼解壓到獨立避重名目錄，讀取指令碼傳回的專案根並繼續唯讀研究，無需額外取得解壓確認。該動作只授權建立研究副本和讀取其內容；運行專案、安裝依賴或解壓工具、修改專案、移動或刪除原檔案、提交和發布仍分別授權。
- 聯網、下載、安裝、運行、生成、寫入、移動、歸檔、刪除、提交、推送和發布分別授權；只有本節隨後明確列出的預設完成契約可以把同一用戶結果內的寫入、提交、推送和遠端驗收合併授權。運行或生成不等於獲得專案寫入權限；預設完成契約之外，提交、推送或發布只授權處理已存在且準確核對的改動，不追溯授權先前寫入，也不包含無關工作樹變化。
- 用戶在請求中明確點名 Project Steward（包括呼叫
$project-steward），並明確要求對現有 Git 專案實施修改、修復、治理、更新或優化時，若當前分支存在已配置 upstream 且用戶沒有要求只改本地、不要提交、不要推送或指定更早停止位置，本輪實施預設完成到：按獲准依賴閉包驗證、精確提交、非強制推送當前追蹤分支，再核對遠端 HEAD 與關鍵消費者；本地驗證後不再第二次詢問是否推送。唯讀請求、隱式路由、無 upstream、建立遠端、改變可見性、刪除、強制推送、改寫歷史、打包、部署和無關工作樹變化不由該預設獲得授權；按references/repository-publication.md在分叉、來源不明變化、未獲授權刪除、憑證、驗證或認證失敗時停止。 - 用戶確認 Project Steward 自我進化方案且未要求只改本地時，當前追蹤遠端存在即預設把整個當前工作區作為一個不可拆分的發布範圍：驗證全部已追蹤修改、未追蹤檔案和現有刪除，使用
git add -A一起提交並推送當前追蹤分支；任何一項不能共同發布時保留完整工作區並停止。該預設不授權建立遠端、強制推送、改變可見性或實施新的刪除。 - 用戶明確要求為現有 GitHub 倉庫接入、修復或取代 Star History 時，確認契約預設包含本輪獲准依賴閉包的提交、推送和遠端驗收；除非用戶明確要求只改本地，否則寫入驗證後不再等待第二次發布授權。該預設不包含建立遠端、強制推送、改變可見性、刪除或無關工作樹變化。
- 每個用戶回合、內部輪次、自動續跑和上下文壓縮恢復開始時，任何工具呼叫或狀態改變前都先從最近一次明確用戶動作恢復尚未完成的結果、範圍、權限和停止位置。只有同一結果仍未交付且範圍、受影響鏈與權限未變時才繼續；唯讀結果已經交付、沒有新的明確動作、用戶改變結果、出現無關問題或需要新增權限時停止並等待確認。審計發現、助手建議、內部計畫、目標名稱、待辦清單和自動提示都不能補造新結果或寫入權限。
- 工作從短動作擴展為多階段、進入等待或證據狀態發生變化時，主動說明擴展原因、已完成檢查點、當前狀態、下一項可觀察結果和所需輸入；狀態不變時不重複洗版，也不能用流程說明掩蓋範圍擴張。
- 新的獨立請求取代尚未完成的結果時，先交接已經寫入或改變的物件、已有證據、尚未驗證的用戶承諾、運行進程、殘留、原權限和停止位置；新請求不授權繼續、回退或清理舊結果。
- 先凍結準確專案根、材料範圍、活動檔案和真實消費者。Git 只在準確專案根直接存在 .git 且當前路徑確需歷史、工作樹或發布證據時使用。
- 來源必須讀到明確末尾；長檔案先取得行數、位元組數或分頁能力，再按穩定區間完整讀取。併發變化觸及行為契約、影響檔案、消費者、驗證或用戶結果時，舊確認失效，重新規劃並確認。
- 多項相互獨立的探測只有在編排器能逐項保留輸出、錯誤和退出狀態時才並行；任何一項會讓整批提前中止時改為獨立執行。批次失敗後保留仍新鮮的成功證據，只把被遮蔽、未執行或狀態未知的項目單獨補跑。
- 專案事實寫回專案現有唯一真源；環境事實寫入獨立用戶檔案；可遷移治理方法才進入本 Skill；模板只接收某類專案每次都應執行的穩定預設。
- 判斷歷史或外部材料中的能力是否已經存在時，先完成獨立結果拆分和必要的因果排序，再遮住來源檢查目標能否認出同一條件、保留同一構成性細節並作出同一具體處理；只有上位治理框架算部分具備。完成逐項比較後才提煉共同機制和特殊維度。
- 驗證按改動風險選擇層級：先運行直接覆蓋本次改動和驗收主張的目標檢查；只改文件、許可證、致謝或純元資料時在相應維護入口通過後停止，不啟動無關瀏覽器或端到端鏈路；公共契約、核心執行時、跨倉庫邊界、發布或目標檢查暴露系統性影響時，才升級為完整迴歸和真實用戶鏈。
- 狀態改變後直接回讀權威目標。完成驗證必須沿正式生產者、傳輸或儲存邊界、消費者和用戶可觀察結果；不能讓消費端手寫假資料或 mock 掉正在驗證的核心鏈路。
- 測試結果用於關閉承諾或宣告完成前，預期關鍵測試身份必須與測試框架實際收集的唯一身份一致；缺失或非唯一身份都只能標為未覆蓋。
- 診斷讀取設定、運行報告、結構化製品或日誌時，按
references/log-audit-standard.md先投影當前判斷需要的允許欄位；未知結構不得整份遞迴輸出，憑證必須在進入工具輸出、對話或診斷匯出前脫敏。
對話學習與自我進化
先完整讀取 references/conversation-learning-and-self-evolution.md。
任一用戶結果含失敗、糾正、保護攔截、臨時繞行或殘留時，再讀取 references/root-cause-remediation.md。讀取順序固定為：按結果恢復完整過程，沿因果層級確定主要學習主題和獨立次級結果，再恢復其中會改變未來治理的具體細節並按共同邊界逐項比較目標能力，之後才提煉共同機制和特殊維度、判斷可遷移性、職能邊界和正式所有者，最後判斷歷史責任。繞行與殘留不得覆蓋更早且證據成立的可控根因；後續糾正改變主要原因時，現有方案與確認立即失效。只有成功結果且不存在這些訊號時，不載入根因方法。
能力比較必須先區分「方法缺失」和「已有方法沒有被路由、執行或驗收」。前者只原位強化唯一方法所有者；後者只修最早失效的主路由、動作門檻、正式消費者或驗證，不在其它檔案增加同義規則。方案按所有者和消費鏈組織，不按對話出現順序堆疊補丁。
用戶只要求分析時保持唯讀。明確要求吸收、自我進化、更新、優化或迭代 Project Steward 時，先交付未來行為、職能邊界、代表性輸出、影響檔案和驗證方式並停下；用戶確認該方案後才修改活動 Skill。確認方案未宣告只改本地時，同時讀取 references/repository-publication.md；當前追蹤遠端存在時，把整個工作區按實際影響驗證，使用 git add -A 將已追蹤修改、未追蹤檔案和現有刪除一起提交並推送當前追蹤分支，核對遠端 HEAD 和工作區無遺漏後才完成。遠端、認證、分支保護、分叉、驗證失敗或任何一項不能共同發布時保留完整工作區並停在準確邊界，不退回升級選擇性提交。
Project Steward 自我進化時必須執行主檔案約束：
- 寫入前記錄 SKILL.md 的行數、字元數和直接 reference 集合，並給每條新增規則指定唯一活動所有者。
- SKILL.md 只擁有路由、觸發條件、讀取順序、權限、輸出和停止位置；完整方法、表格、檢查清單與例外由對應 reference 唯一擁有，主檔案只保留直達鏈接。
- 寫入後 SKILL.md 不得超過 220 行或 14,000 個字元，並保持全部活動能力可直接到達。新路由使預算超限時，必須在同一回改動中遷移或合併舊細節。
- 無法在預算內保留既有能力、正式消費者和驗證時，停止寫入、重新規劃，不得宣稱完成。
改動前預防
先讀取 references/change-prevention.md，由它負責目標行為、唯一真源、影響圖、最終介面、舊路徑退出和真實用戶鏈驗收。按問題疊加：
- 持久操作、佇列或排程器的有界批次與積壓排空、恢復、重啟、成組產物，或常駐有狀態服務中可發現會話與共享資源的併發准入、釋放和關閉：
references/durable-operation-governance.md - 任務狀態、進度或自動續跑：
references/task-progress-governance.md - 高成本結果需要分階段展示、確認、連續自動執行或按上游變化失效：
references/staged-result-governance.md - 同一結果由多份規格、計畫、任務或研究產物表達且需決定演化關係，或涉及派生產物、語義快取、工作單元切分、資源池利用或重複 Agent 編排：
references/derived-artifact-governance.md - 專案級 CI 的驗證計畫、執行環境快取、測試資源分層、耗時分片、早失敗和精準重跑：
references/ci-execution-governance.md - 運行中設定會重建共享服務、provider、儲存根或組合圖：
references/runtime-generation-governance.md - 難重現、時序、併發、背壓或昂貴完整鏈：
references/hard-to-reproduce-diagnostics.md - 外部、持久化、模型、網路或進程 JSON 存在多處解析、容量、原子分片、重放游標或契約歧義：
references/structured-data-boundary.md - 模型參與任務判斷、狀態表達、運行時事件或結構化回覆，需要核對訊息來源、角色、路由、線請求與呈現職責：
references/model-mediated-operation-governance.md - 以外部原始碼為一次性起點建立獨立產品，或選擇性吸收其擴展生態：
references/source-fork-and-ecosystem-adoption.md；實際複製程式碼時同時讀取references/license-governance.md - 產品體驗或介面：
references/product-experience-governance.md；需要設計或互動方法時再讀references/ux-design.md
只有用戶明確授權實施時修改專案；只要求計畫則停在影響圖、目標邊界、遷移順序和驗收契約。
根因治理
先讀取 references/root-cause-remediation.md。診斷停在證據、影響範圍與最終修法；實施才一次遷移全部生產者、邊界和消費者，並退出舊架構。按問題疊加：
修復承接本任務先前的綜合審計，或用戶明確要求修復該審計中的全部問題時，原審計交接帳本繼續作為結項契約；寫入前固定讀取 references/change-prevention.md，最後一次相關修改後返回 references/project-audit.md，從原覆蓋範圍和當前已接受契約重新生成覆蓋與發現帳本。單點缺陷不會僅因歷史中存在無關審計而擴張到這條鏈。
- 持久操作、佇列或排程器的有界批次與積壓排空、恢復，或常駐有狀態服務的會話准入與釋放競爭：
references/durable-operation-governance.md - 任務進度或持續狀態：
references/task-progress-governance.md - 返工來自階段確認缺失、確認物件漂移或變化被錯誤擴散：
references/staged-result-governance.md - 返工來自多份產物關係不明、理由在重新生成時丟失、全量重算、錯誤快取失效、危險切分、資源誤判或編排往返：
references/derived-artifact-governance.md - 專案級 CI 反覆慢測、環境準備浪費、分片失衡、跨平台預檢過晚或失敗後無差別重跑：
references/ci-execution-governance.md - 運行時操作跨越服務代次、熱設定交易或物理根切換：
references/runtime-generation-governance.md - 難重現或低可觀測問題：
references/hard-to-reproduce-diagnostics.md - 結構化 JSON 的編碼、資源預算、邏輯訊息容量、原子分片、重放游標、數值、schema 或錯誤語義分叉：
references/structured-data-boundary.md - 模型回覆、任務狀態或結果呈現與真實執行時不一致，或需要定位實際傳送給模型的請求：
references/model-mediated-operation-governance.md - 可視層級、變換或動效所有權：
references/interaction-motion.md；需要實際運行畫面驗收時再讀references/implementation-review.md - 工具、路徑別名、執行環境或長任務：
references/user-environment-governance.md - 事件、版本、歷史或快取把計畫影響範圍誤當成實際變更事實：
references/change-prevention.md的「計畫範圍與實際變更事實分離」契約 - 局部狀態、心跳或遙測更新覆蓋、清空了未宣告欄位，或者消費者無法區分完整快照與局部補丁：
references/change-prevention.md的活動投影更新契約 - 原始碼、README、指令碼、測試或設定硬編碼本機與部署事實：
references/change-prevention.md的專案運行設定邊界；用戶機器事實同時讀取references/user-environment-governance.md - 內聚、耦合、語義重複或上帝模組：
references/architecture-cohesion-governance.md
外部工具相容性
讀取 references/external-tool-compatibility.md。相容關係涉及跨專案根的公共契約、派生快照或複合交付包時，同時讀取 references/change-prevention.md 的公共契約、契約採用閉包與跨根交付邊界。相容性檢查保持唯讀，並按明確介面卡逐層報告可執行產物、能力契約、呼叫與隔離、臨時輸入、上游線協議、結構化結果、宿主獨立核驗和用戶鏈；只有明確授權修復或接入時才修改獲准專案根。
專案研究與講解
先讀取 references/project-research.md。只讀取回答當前問題所需的專案表面；用戶明確要求完整研究或能力採用時才擴展覆蓋，並同時讀取 references/source-fork-and-ecosystem-adoption.md，先追溯原始上游並區分直接複用與方法學習；確認會直接複用程式碼或資源時再讀取 references/license-governance.md，把第三方資源與致謝寫入目標專案 README。需要衡量效果、失敗樣本和置信度時讀取 references/project-effectiveness-review.md；需要儲存可複核報告時讀取 references/project-research-report.md。原始碼歸檔先用 scripts/extract_project_archive.ps1 和 -DestinationRoot <目標根> 解壓到獨立目錄；沒有另行指定目標根時使用 E:\Work\BaiduSyncdisk\Code\Example。指令碼傳回專案根後立即讀取 references/archive-safety-screening.md 並運行 scripts/inspect_extracted_project_safety.py；只有該方法確認重大隱患時才進入用戶輸出，否則靜默繼續原研究。
專案目錄治理
讀取 references/repository-directory-governance.md。先用 scripts/inspect_project_tree.py 取得唯讀物理與 Git 證據，再核對每個候選目錄的正式生產者、路徑真源、消費者和生命週期；檢查、解釋與計畫停在證據帳本，只有明確授權整理、移動或歸檔時才改變準確路徑，刪除繼續遵守單獨授權。移動觸及活動原始碼、模型、資料、素材、建構或運行入口時同時讀取 references/change-prevention.md；已經存在舊路徑、雙讀、同步副本或半遷移時再讀取 references/root-cause-remediation.md，一次遷移消費者並退出舊入口。
專案基線與模板
讀取 references/project-template-system.md。唯讀請求停在 inspect、plan 或 verify；adopt、upgrade 或專案設定寫入需要明確授權，並驗證正式消費者。
模板演進
讀取 references/template-evolution.md。先證明候選是穩定預設而非仍需臨場判斷的方法，再同步模板版本、註冊表、雜湊、文件和消費者測試。
產品體驗與介面治理
先讀取 references/product-experience-governance.md，再按以下固定入口和條件專項執行：
- 介面診斷、評價、優化或重建固定讀取：
references/ux-design.md、references/interface-experience-quality.md、references/interface-problem-patterns.md、references/implementation-review.md。修改前先凍結全部相關視窗、頁面、面板、覆蓋層、主要狀態和用戶旅程；不能把截圖中最醒目的局部問題當成完整審查範圍。 - 從零設計或改變視覺方向：
references/design-method.md、references/visual-direction.md、references/surface-registers.md - 佈局、設計系統、互動和動效：
references/layout-responsive.md、references/design-system-alignment.md、references/interface-guidelines.md、references/interaction-motion.md - 參考介面忠實重建：
references/reference-interface-reconstruction.md - 已確認是桌面、Tauri/Vue 或本地檔案工作區時，對應讀取
references/desktop-app-governance.md、references/tauri-vue-governance.md、references/local-file-workspace-governance.md；專案形態已經成立時不得因當前反饋只提到顏色、間距或文案而省略平台外殼。 - 任務狀態或進度：
references/task-progress-governance.md
依賴既有定位或設計系統時，每個任務最多運行一次 scripts/context.mjs；忠實重建參考介面時由 assets/reference-reconstruction/component-spec.md 承擔元件規格。
倉庫建立與發布
讀取 references/repository-publication.md。區分初始化、提交、遠端建立、推送、可⾒性、檢查與部署；每一步只執行已經授權的停止位置，並在狀態改變前後核對準確倉庫身份、索引、分支、遠端和併發變化。
README 與主頁
先讀取 references/readme-delivery.md，用一份交付帳本檢查 Git 邊界、README、正文、視覺、多語言、許可證、Star History、GitHub Topics、倉庫元資料、驗證與停止位置；唯讀請求停在同一帳本，明確要求優化、重寫或完整處理時才實施。隨後讀取 references/content-architecture.md；完整優化或涉及 Logo、hero 時讀取 references/visual-direction.md，先完成程式碼優先的正式身份源調查，再按需讀取 references/project-native-hero.md 和 references/github-readme-canvas.md。需要多語言、個人入口或倉庫狀態區時讀取 assets/readme-profile/profile.json，由 scripts/readme_header.py 消費真實檔案、倉庫身份、許可證和明確解析的專案導航。已有公開 GitHub 倉庫的完整 README 優化把 Star History 與 Topics 都作為預設交付項：Star History 讀取 references/github-star-history.md 和 references/repository-publication.md，Topics 透過 scripts/github_topics.py 寫入並回讀；除非用戶明確退出或目標客觀不適用，缺少任一真實消費者的成功結果都不能完成整項交付。按需選擇：
- SVG 與混合視覺：
references/svg-production.md、references/hybrid-svg-production.md - 動效：
references/motion-production.md - 平台邊界：
references/platform-guidelines.md - 自託管 Star History 的專項診斷或接入：
references/github-star-history.md；只問失效原因或現況時保持唯讀，實施時精確提交並推送呼叫倉庫改動，手動運行工作流，再沿 API、生成器、輸出分支、raw SVG 和 README 消費端的真實鏈路驗收
README 不作為每項內部治理規則的第二份活動真源；自我進化只有改變公開身份、讀者路徑、主要入口或維護導航時才更新 README。完成後運行 scripts/audit_readme.py，並在實際渲染表面核對。
許可證治理
先讀取 references/license-governance.md。用戶確認具體方案後再讀取 references/license-rollout.md 並實施；唯讀請求停在內容邊界、第三方依賴與方案比較。
人性化日誌
讀取 references/log-audit-standard.md。沿一次真實操作檢查生產、上下文、儲存、讀取和最終查看結果；不以一條漂亮示例取代完整事件鏈。
用戶環境檔案與執行環境
讀取 references/user-environment-governance.md。檔案 schema 由 assets/user-environment/profile.schema.json 負責，確定性操作由 scripts/user_environment_profile.py 負責。inspect、plan、verify 和 resolve 保持相應唯讀或消費邊界；apply --write 需要明確檔案寫入授權，且不自動授權安裝、下載或系統設定修改。
專案綜合審計
讀取 references/project-audit.md。用戶詢問實施計畫完成度時，先從原計畫建立逐項符合性帳本；獲准修復後必須從原計畫和當前已接受契約重新生成一次全新複查，不沿用舊完成標記，也不從現有測試反推計畫範圍。全面檢查則先按專案形態建立全部適用維度的覆蓋帳本，再載入這些維度要求的專項；不得只根據已經發現的問題回填審查範圍。唯讀審計不自動治理。需要評估用戶效果時追加 references/project-effectiveness-review.md，需要檢查任務體驗時追加 references/task-experience-audit.md。
平台模板資源
處理對應專案類型時按需讀取：
- 桌面應用：
references/desktop-app-governance.md - Tauri v2 + Vue：
references/tauri-vue-governance.md - 本地檔案工作區：
references/local-file-workspace-governance.md
這些資源是活動方法，不等於專案已經採用模板；只有明確採用並由正式消費者讀取的 .project-steward/project.json 才構成專案模板狀態。
輸出與完成
輸出先給結論，再說明範圍、證據、未知項和下一動作。分析不得寫成已經實施；結構檢查不得寫成真實用戶鏈成立；當前任務行為核對不得寫成獨立冷啟動已經證明。
有影響圖時至少包含生產者、傳輸或儲存邊界、消費者、最終用戶結果、唯一真源、舊路徑退出條件和驗收入口。涉及多個歷史結果時逐個報告主要原因、成功機制、能力缺口、正式所有者和驗證等級。
只有活動路由、對應方法、正式消費者、確定性測試以及本輪獲准的真實用戶鏈都一致後，才報告完成。