项目上下文新鲜度核验工作流

项目上下文新鲜度核验工作流

3个实用技能 · 3步完成 · 每一步都能单独使用

把长期项目里的 CLAUDE.md、AGENTS.md、技能说明和交接笔记从“写过就一直信”变成可复核的上下文清单：先分类和登记来源，再检查验证日期、链接关系和动态事实，最后形成保留、复核或归档候选。套餐只生成静态证据和人工复核计划，不删除文件、不改仓库。

3个可下载技能 · 每个技能可单独运行

3步自动化工作流

🔵 1 项目上下文清单整理

技能文件：project-context-inventory

解决什么： 持久规则、当前状态、技能说明和会话交接文件混在一起，缺少来源、验证日期、内容类别和谁仍在引用它们的清单。

What you get: READY/REVIEW、文件清单、稳定/动态内容分类、来源引用、链接关系和 inventory_hash。

↓ 本步结果自动进入下一步

🟢 2 项目上下文新鲜度审计

技能文件：project-context-freshness-auditor

解决什么： 旧版本、当前分支、行号、待合并状态等动态事实留在持久上下文里，会让智能体根据过期信息工作；无链接的旧交接文件还可能继续误导后续会话。

What you get: KEEP/REVIEW/ARCHIVE_CANDIDATE、验证年龄、来源缺口、未链接风险、动态事实风险和 freshness_hash。

↓ 本步结果自动进入下一步

🟠 3 项目上下文复核门禁

技能文件：project-context-review-gate

解决什么： 清理上下文时直接删除会破坏历史和恢复能力，需要把候选文件、保留理由、归档动作和人工决定放在同一份门禁结果里。

What you get: READY_FOR_HUMAN_CONTEXT_REVIEW/BLOCKED、保留清单、复核清单、可归档候选、archive_action=MOVE_TO_REVIEW_ARCHIVE_NOT_DELETE、human_decision=PENDING 和 context_release_hash；这是最终交付。

实际示例

脱敏样例包含一个仍被 README 引用且最近核验过的 CLAUDE.md，以及一个长期未核验、没有引用关系的交接文件。第一步建立上下文清单，第二步把前者标为 KEEP、后者标为 ARCHIVE_CANDIDATE，第三步生成需要负责人确认的复核包，并明确只能移动到审查归档区，不能直接删除。示例不会读取仓库或移动文件。

适合谁

维护长期 Claude Code、Codex 或其他智能体项目的开发者；同时使用 CLAUDE.md、AGENTS.md、技能说明、记忆索引和交接笔记，希望减少过期上下文误导的团队。

买家只需提供

• 脱敏的上下文文件清单、内容类别和最近验证日期

• 来源引用、被哪些文件或入口链接、负责人占位信息

• 统一的 as_of 日期、最大允许验证年龄和归档复核策略

• 不提供仓库凭据、个人信息、私有源码或真实项目路径

使用方式

1. 使用 Python 3.10 或更高版本，准备相对路径的脱敏 JSON 清单。

2. 依次运行清单整理、新鲜度审计和复核门禁，也可以单独运行任一步。

3. 由项目负责人查看 KEEP、REVIEW 和 ARCHIVE_CANDIDATE，再决定是否在自己的仓库中移动或更新文件。

交付与验收

• 三个独立技能目录，每个包含元数据、技能说明、执行器、文档和脱敏样例。

• 三步可重复运行：清单整理、新鲜度审计、复核门禁；每个技能也能单独使用。

• 缺少验证日期、来源、链接关系、内容类别或超过 freshness 阈值时有明确 REVIEW；未链接且过期的上下文只进入归档候选。

• 输出只生成证据和人工计划，不读取源码、不删除文件、不移动文件、不连接 Git 或外部服务。

服务说明

脚本只处理买家有权使用且已经脱敏的静态上下文清单，不连接 Claude、Codex、Git、仓库或业务系统，不读取秘密、不写回文件。新鲜度核验不等于内容语义正确，也不保证智能体行为一定改善。套餐不包含文档重写、仓库迁移、自动删除、持续监控或结果保证。