Bagel-EW/brief-yourself

Brief Yourself 1.0.1｜Personal Context Layer

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	用户回合	预计时长
Quick	5	2–3	5–10 分钟
Standard（默认）	8	3–4	15–25 分钟
Deep	12	4–5	30–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，并列出来源范围、未覆盖项、敏感边界和下一次值得验证的问题。结束时明确：这是基于当前授权材料的、截至目前的工作画像；用户可以修正、限制使用、拒绝或删除任何一项。