工作區協作 v2.1
目標:用少量狀態支援協作,細節按需讀取。具體任務分工以用戶指派為準。腳本路徑相對本 skill 目錄;工作區參數用絕對路徑。適用於 Codex 和 DSH。
進入或恢復
執行 node scripts/workspace.mjs context --workspace WORKSPACE --session SESSION。
SESSION 使用執行環境給出的當前對話 id;不可獲取時保留 unknown,不猜身份、不認領。
未啟用時繼續用戶原任務;只有用戶明確指定主對話並啟用管理時才執行 init。
新上下文先取完整簡報;同一上下文後續傳上次完整處理過的 --since STAMP,只讀變化。
scope=declared-metadata 只檢查登記資訊;它不證明原始檔案未變或未登記對話不存在。
執行
role=main:彙總登記任務,處理 alerts、審查衝突與重複勞動;階段結束用summary生成sum.md。role=child:只維護自己的任務記錄和產物;需要上下文時優先detail --task ID。- 接任務、狀態變化、結果交接時用
task --file INPUT.json登記;欄位和命令見 命令參考。普通回覆無需改台帳。 - 共享寫入前先登記
writes;認領衝突則串行交接。check核對已登記路徑,編輯前重讀目標檔案。 sum.md由主對話腳本生成;子對話更新各自記錄。相同內容不增加任務版本。
資訊不足時
more=true 用同一 --since 和 --offset NEXT 讀完相關頁,再保存 stamp。
unknown、掃描不完整或解析錯誤都保留為問題;詳細檔案檢查用 check --offset N。
發現散落產物、歸屬不明或待認領 claims 時,讀 認領與歸攏。
需要 DSH 日誌線索時才讀 取證命令;舊工作區啟用見 遷移。日常只讀簡報。
只依賴當下可用的狀態;接管主對話用顯式 handoff。檔案時間不代表對話是否運行。
這些記錄協調合作,不替代工具權限,也不阻止未遵守約定的外部寫入。