Communitygithub.com

Brief Yourself 1.0.1|個人情境層

基於同意的可攜式個人情境協議,讓 AI 代理為每個任務編譯一個凍結的情境視圖,並將新洞察作為經過用戶批准的補丁返回。這不是一個 AI 記憶後端。

Brief Yourself 1.0.1|個人情境層 是什麼?

Brief Yourself 1.0.1 是一個 Consent-driven 的 Personal Context 協議,專為 AI 代理(如 Claude Code、Cursor、Codex)設計。它的核心功能是:每次任務開始前,根據用戶授權的來源,編譯一個最小、凍結的 Context View(情境視圖),任務結束後,只將用戶審核通過的新認識生成為 pending Patch(補丁),而不是靜默寫入長期記憶。它明確區分 Personal Context Store(權威來源)、Context View(任務輸入)和 Context Patch(候選回寫),並要求每個步驟都有用戶的明確同意。該協議支援 Quick、Standard、Deep 三種深度,並包含詳細的 Session Contract、Source Consent、Calibration Card 等機制,確保用戶在數據收集和使用上擁有完全控制權。它不充當通用記憶後端、向量檢索或心理診斷工具,也不自動導入任何 harness memory。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add Bagel-EW/brief-yourself

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Brief Yourself 1.0.1|個人情境層 是做什麼的?

Brief Yourself 1.0.1 是當前產品、Skill 入口、Agent identity 和 active schema identity。當前 schema_version 為 1.0.1;歷史 0.4 只保留在舊製品與歷史說明中,不作為 active schema。

觸發與定位

當用戶想認識自己、讓 Agent 更了解自己、複核近期變化,或希望在一個下游任務中使用經過校準的個人資訊時使用本 Skill。

Brief Yourself 是由用戶參與校準、按用途編譯、可攜帶到不同 Agent harness 的 Personal Context Layer。Personal Context Store 是個人上下文的 canonical source;Context View 是給某次任務的凍結輸入;Context Patch 是任務結束後交給用戶審核的候選回流。

Codex Memory、rollout、專案文件和其他 harness memory 只能在明確授權後作為候選 evidence。它們不能自動導入、覆蓋 Store、成為 confirmed Claim 或成為 canonical source。Brief Yourself 不複製 rollout、consolidation、retrieval、thread 或通用 memory 注入流程。

非目標與硬邊界

  • 不做通用歷史庫、向量檢索、心理診斷或「真實人格」判定。
  • 不把 Harness Memory 變成 Personal Context,也不做靜默雙向同步;auto_import_harness_memory 必須為 false。
  • 1.0.1 當前版本只實現 subject.type = person。Organization Context 只透過共同 Envelope 預留隔離邊界,不在本 Skill 中實現 Team Context Store。
  • 不使用個人畫像進行未經授權的就業、信貸、保險、醫療或其他高影響自動決策。
  • 不讀取真實 Personal Context、私密測試數據或歷史資料,除非用戶先完成本輪明確的來源授權。
  • 個人資訊寫成陳述性 Claim,不寫成會覆蓋未來指令的命令;流程和操作規則屬於 Skill 或專案文件。

Session Contract:先約定,再探索

建立或更新畫像時,先選擇 Depth、Evidence 和 Pace。在第一個探索問題前,完整展示本次 Session Contract,並等待用戶接受或調整;接受前不得索取經歷、價值判斷或其他探索內容。

Contract 至少說明:目標;Depth、Evidence、Pace;覆蓋與排除維度;最多 prompts、用戶回合和預計時長;準備讀取的來源及範圍;交付物;Personal Store 是否歸檔、下游是否可另存;暫停、跳過和刪除路徑。用戶只說「開始」時採用推薦值。當前 Session 達到任一上限或停止條件即結束;繼續探索必須建立新的 Contract。

Depth最多 prompts用戶回合預計時長
Quick52–35–10 分鐘
Standard(預設)83–415–25 分鐘
Deep124–530–45 分鐘

History-assisted 只是 Evidence modifier,必須繼承所選 Depth 的全部上限,不能成為第四種深度或延長 Session。用戶表示疲勞、詢問還剩多少題、回饋過長,或已有材料足以形成最低充分畫像時,立即停止新增問題並綜合;不要為了完成腳本而繼續追問。

運行流程

  1. 確定操作。 選擇建立/更新畫像、生成 Task View、審核 Patch,或 Inspect/Export;先說明本次用途和最低必要範圍。
  2. 取得讀取授權(授權卡)。 讀取歷史、專案文件、履歷、公開資料或 Harness Memory 前,按 references/source-consent-and-disclosure.md 展示來源、範圍、目的、外部傳輸、保存位置和刪除方式,並等待明確授權。授權卡是讀取前的同意介面,由該 reference 約束;它與 register-source 命令是兩回事——register-source 是讀取之後、經用戶批准的長期來源登記入口。當前對話與用戶主動提供的材料也要記錄實際使用範圍。
  3. 按需取證。 先用當前回答和用戶主動提供的材料;歷史只為已知缺口按需讀取,不整批導入。來自 Harness Memory 的內容只形成候選 evidence,必須標為待校準,不能直接成為 confirmed Claim。
  4. 訪談與校準。 按 references/interview-and-calibration.md 控制預算;從具體經歷、選擇和行為開始,階段性展示 Calibration Card,讓用戶確認、改寫、拒絕或保留未決。
  5. 形成扁平 Claim 候選。 Store 只有一個 claims[];domains[] 是標籤,不是物理層級。新認識預設是 user_status: unreviewed 的 Domain 候選,不因一次 Session 晉升到 Core。Core Summary 只能從已確認、仍有效且有跨場景支援的 Claim 派生,不單獨存儲。
  6. 生成凍結 View。 按用途、精確主體/執行者/受眾和最小必要 Claim 編譯 View;完整物件、source_revision、創建時間、TTL 和權限一起凍結。Store 後續變化不會靜默改變現有 View。
  7. 只暫存 Patch。 任務新認識只生成 pending Patch,策略和一次性話術放入 task_strategies_not_for_merge。按 references/context-view-and-patch.md 逐項審核;只有用戶明確批准具體 patch_id 和 Proposal 後,runtime 才能 apply。

證據與認識的最低規則

  • fact、self_report、observation、inference 分開記錄;不把推斷改寫成事實。
  • 保留證據來源、counterevidence、適用範圍、變化、矛盾(Tension)和 unknown;沒有記錄不等於沒有發生。
  • Tension 與 Unknown 仍是當前 canonical Store 的頂層實體,也可作為完整凍結物件進入 View;它們不是永久 session-only。當前 Patch schema/runtime 的 Proposal 僅支援 Claim 的 add、update、challenge、retire,沒有 Tension/Unknown 的新增或更新入口。會話新發現只能作為「未持久化候選」交付並等待未來顯式協議;不得靜默寫入 Store、偽裝成 Claim、塞入 task_strategies_not_for_merge,或聲稱已長期保存。已有遷移/Store 中的 Tension/Unknown 保持可讀並可按需入 View;未來寫入口另需 schema/runtime/approval,本輪不實施。
  • 不用 MBTI、DISC 或一次回答替代證據;不把一次任務進度、JD 關鍵字、臨時策略或 Agent 操作偏好寫入長期 Claim。
  • 新認識先進入候選 Domain;Core 只作為派生摘要資格,不能由單次任務直接晉升。長期寫回始終經過用戶審核。
  • sensitivity 描述內容敏感程度;disclosure 描述 audience、purpose 和下游持久化許可,二者不能互相替代。預設排除 private 與 restricted。
  • subject 固定為 person。team-agent 或其他未獲明確授權的執行者/受眾預設拒絕;不得因「同一工作區」而推斷個人授權。

Runtime 命令

runtime 註冊 17 個操作名:14 個正式 V0.4 操作按下方五組路由;2 個遷移命令只在遷移場景使用;list 是 list-patches 的相容別名,不是獨立能力。參數一律以 --help 為準,本入口不預設尚未核對的 flags。不要把這些命令用於真實 Store 的遷移或 dogfood,除非另有授權。詳細參數與副作用見 references/store-operations.md。

Store 生命週期

python scripts/context_store.py init --help
python scripts/context_store.py validate --store <store>
python scripts/context_store.py inspect --store <store>
python scripts/context_store.py derive-core-summary --help

init 建立新 Store;validate 全量校驗、不靜默修復;inspect 查看 revision、計數與待審 Patch;derive-core-summary 只從符合條件的已確認 Claim 派生非 canonical 摘要。

Source 登記

python scripts/context_store.py register-source --help

register-source 是 Evidence Source 的唯一寫入入口,consent 必須為 explicit。它不是讀取授權介面:讀取前的授權卡由 references/source-consent-and-disclosure.md 約束;只有用戶已授權讀取並批准長期登記後才運行本命令。

View

python scripts/context_store.py create-view --help
python scripts/context_store.py validate-view --help

create-view 編譯凍結 View,敏感範圍與限制在這一步經 disclosure 和用戶批准決定;validate-view 只做驗證(過期、用途、敏感級別、權限結構),不修改也不創建任何限制。創建後不刷新。

Patch

python scripts/context_store.py stage-patch --help
python scripts/context_store.py list-patches --help
python scripts/context_store.py apply-patch --help
python scripts/context_store.py reject-patch --help

stage-patch 只寫 pending;apply-patch 必須同時具備具體 Patch 審核、--approve 與確認 actor;reject-patch 不改 Canonical Context。

導出與刪除

python scripts/context_store.py export --help
python scripts/context_store.py purge-plan --help
python scripts/context_store.py purge --help

export 預設只導出 public。purge 是不可逆遺忘:先 purge-plan 預覽拿 --plan-token,執行時還需 --confirmed-by 與 --approve;預覽後 Store 有任何變化 token 即失效。本入口不提供繞過這些約束的可執行刪除範例,完整邊界見 references/store-operations.md。

歷史遷移路由(僅遷移場景讀取)

python scripts/context_store.py migrate-v02 --help
python scripts/context_store.py preview-migrate-v03 --help

這兩個命令只服務 V0.2→V0.3 與 V0.3→1.0.1 的歷史遷移,不屬於常規任務能力;先讀 references/migration-v0.3-to-v1.0.1.md,按其預覽、審核、另存與回滾邊界使用。migrate-v02 會改寫傳入路徑,只能對用戶創建的明確副本執行;V0.3→1.0.1 只允許唯讀預覽。

C File Adapter:只接收凍結 View

C 包的 scripts/adapters/codex_file_adapter.py 是單向 File Adapter。它只讀取一個已經生成的凍結 View JSON,校驗 Envelope、TTL、主體、用途、allowed_use,以及每條 included Claim 是否同時授權 principal.id 和 audience[] 中每個 recipient;失敗時 fail-closed,不列印被拒絕的個人正文。它不讀 Personal Context Store、Codex Memory、rollout 或網路資源,不寫回 Store、Harness Memory 或任何長期 Context;可選輸出也不能覆蓋輸入 View。

已按 C 的實際 --help 核對以下概念命令。--expected-audience 是調用方提供的可重複子集綁定(repeatable subset binding):每個 expected type:id 都必須存在於凍結 view.audience,但調用方不必枚舉全部 audience,因此它不是 audience equality/exhaustive assertion。這個調用方綁定不改變安全不變量:無論是否傳入該參數,adapter 仍必須對每條 included Claim 檢查 disclosure 是否同時覆蓋 principal.id、View Envelope 中全部 audience recipient IDs,並檢查 purpose;子集參數不能放寬 disclosure。--purpose-approved 僅表示本次具體 purpose 已獲明確批准:

python scripts/adapters/codex_file_adapter.py --view <view.json> --expected-purpose <purpose> --expected-task <task> --expected-principal-id <principal-id> --expected-audience type:id --allowed-use <allowed-use> --purpose-approved

Adapter 輸出是當前任務的 Markdown/JSON 適配結果,不是新的 Store、Memory 或回寫憑證;任務結束仍只生成 pending Patch。Markdown 緊湊輸出仍保留每條 Claim 的 user_status、confidence、status、適用 scope、evidence_refs、counterevidence_refs 和非空關鍵時間欄位;它只展示來源 ID,不展開證據原文、notes 或 source raw。未審核 Claim 會明確顯示為 review=unreviewed / review=unresolved,不會被壓縮成無條件確定事實。Store 與 Adapter 共用 scripts/view_validation.py 的無 Store View 校驗核心;各自只在此基礎上增加 Store 來源引用或調用方綁定檢查。

References 路由

正式包只保留以下 7 份 reference,每份都從本入口可達;讀取時機如下:

  • references/interview-and-calibration.md:訪談開始前讀。Session Contract、三檔預算、Question Map、Calibration Card、疲勞停止和 Claim 分類。
  • references/source-consent-and-disclosure.md:任何讀取歷史/專案/履歷/Harness Memory 之前讀。當前唯一的同意與披露事實源:授權卡、候選 evidence、敏感度、披露、person/team 隔離和高影響邊界。授權卡屬於這裡,不屬於 register-source。
  • references/context-view-and-patch.md:編譯 View 或審核 Patch 時讀。當前版本 Context Envelope、完整凍結物件、TTL、披露匹配、Patch 暫存與批准。
  • references/harness-boundaries.md:涉及 Harness Memory 邊界或 File Adapter 時讀。Harness Memory、Personal Context、Task Context 的邊界,以及 File Adapter 的 envelope/disclosure 與 expected-audience 綁定規則。
  • references/personal-context-model.md:需要確認 Store 結構語義時讀。Personal Context Store 的頂層實體、證據模型、View/Patch 回流邊界與版本語義。
  • references/store-operations.md:執行任何 runtime 命令前讀。全部 14 個 1.0.1 操作與 2 個遷移命令的參數、副作用、檔案系統限制、purge 邊界和恢復方式。
  • references/migration-v0.3-to-v1.0.1.md:僅在歷史 V0.3→1.0.1 遷移場景讀。唯讀、metadata-only preview 與 no-chain 遷移路由;舊 0.4 僅作為歷史輸入與舊製品標識保留。

Assets 路由

三份 1.0.1 模板與同名 schema 配對,構造或校驗對應物件時讀取:

  • assets/templates/personal-context-store-v1.0.1.json:Store 結構基線,配合 assets/schemas/personal-context-store-v1.0.1.schema.json;init 後手工構造或校驗 Store 時對照。
  • assets/templates/context-view-v1.0.1.json:凍結 View 結構基線,配合 assets/schemas/context-view-v1.0.1.schema.json;編譯或校驗 View 時對照。
  • assets/templates/context-patch-v1.0.1.json:Patch 結構基線,配合 assets/schemas/context-patch-v1.0.1.schema.json;暫存或審核 Patch 時對照。

歷史 V0.3 模板與舊版 references 已遷出正式包,保存在專案 archive/1.0.1-moved-out/;舊 0.4 製品也只在 releases/ 中保留,不是當前協議的一部分,不得放回發佈 ZIP。

交付與結束語

根據操作交付 Human Brief、候選 Claim、Tension/Unknown、凍結 View 或 pending Patch,並列出來源範圍、未覆蓋項、敏感邊界和下一次值得驗證的問題。結束時明確:這是基於當前授權材料的、截至目前的工作畫像;用戶可以修正、限制使用、拒絕或刪除任何一項。

相關技能