用途:保持 Compound Master 状态文件可作为恢复工作的入口。它保留完整记录,但把旧叙述与证据移出实时上下文路径;同一模式也适用于显式压缩 Compound Master 指令:保持实时路由简短,把阶段细节移入按需加载的引用而非删除。
主要能力:识别状态文件(优先 docs/orchestration/compound-master-state.md,用户指定则用其路径,仅仓库根存在 compound-master-state.md 时使用并保持归档路径为仓库相对路径);运行结构脚本 compact_compound_state.py 归档压缩前完整状态、构建精简脚手架,无法识别可操作恢复信号时拒绝写入;人工整理精简状态,保留当前计划、模式、源路径、活动包、分支/基线、开放 PR/Jira 引用、阻塞项、所需用户决策和确切下一步调用;历史阶段保留简短摘要并链接归档细节;更新 Compound Master 状态预期,记录精简状态路径、归档路径、脚本正常完成或人工回退、以及下次恢复需知的歧义。
使用方式:先加载 references/safety.md 与 references/state-contract.md。先运行 python3 skills/krt-state-archivist/scripts/compact_compound_state.py --state <state-path> --dry-run 检查输出,安全后再去掉 --dry-run 执行。指令压缩时不运行状态脚本,手动做实时/归档拆分,并用仓库技能校验器验证。
适用场景:Compound Master 编排状态、相邻生成状态产物,以及用户要求降低上下文负载时的显式实时上下文入口。
限制:不压缩无关项目文档;脚本是结构工具,不替代代理判断;脚手架标记 CURATION REQUIRED 时不得当作最终事实;不得在未先写完整归档快照时覆盖状态文件;活动阶段、阻塞或下一步不明确且无法从关联产物恢复时不得压缩;状态含密钥或凭据时停止并请求脱敏决定;不得对生成文档运行格式化或大范围清理。最终输出状态归档状态、状态路径、归档路径、恢复入口与备注。