maintain-project-knowledge git:20260817.7056cd2A

Immutable. This exact content never changes and is served at /api/v1/blob/66db7e7fab38a68b.

---
name: maintain-project-knowledge
description: 维护项目内的 Context 知识生产工作区；用于检查已登记仓库和文档来源、判断项目影响范围，并把生命周期动作交回已安装的 Context Skill。用于真实项目前，请修改名称、描述、项目事实和影响映射。
---

# 维护项目知识

本 Skill 是项目适配层，不复制 Context 工作流。先读取已安装的 Context
Skill，并以当前 Route、资源和命令为权威；这里只保留稳定的项目事实和来源
影响映射。

## 仓库来源的获取和更新

先检查当前 Context Route。已登记仓库模块缺失或本地链接断开时，使用 Route
选择的仓库恢复流程，让用户选择已有 checkout、授权在一个限定目录内扫描，
或明确允许 clone 已登记的固定 commit。

checkout 已存在时，先检查 origin、HEAD、dirty 状态和已登记 subpath，再询问
用户保持当前登记版本，还是更新到另一个明确 commit。没有单独授权时，不得对
外部 checkout 执行 pull、切换、清理或 reset。

只有当每个目标模块都对应已登记 remote 和 commit、全部 subpath 存在、未知
本地修改得到保护、Context 已物化模块链接，并且当前 Route 不再报告仓库未
就绪时，仓库来源才可以进入知识更新。

在这里补充本项目稳定的“仓库变化 → 提取范围”映射。维护过程中不得仅根据
文件名临时猜测影响关系。

## 远程文档来源的获取和更新

通过当前 Context Route 以及宿主安装的文档提供方 Skill 或 CLI 读取已登记
文档。本节保持简短：登录、权限、采集、子页遍历和保真诊断由当前步骤选择的
提供方与 Context 资源负责。

只有当来源身份保持稳定（除非用户明确新增来源）、当前账号能够读取所需正文
和资源、需要正文的子页已作为独立来源处理、采集不存在阻塞性 fidelity error，
并且当前 Route 允许开始结构或提取工作时，远程文档才可以进入知识更新。

在这里补充本项目的来源归属、预期文档类型和更新边界。不要把凭据、来源正文
或易漂移的完整命令写进 Skill。

## 项目事实与完成标准

只记录长期稳定的项目路径、包输出、物理仓库与逻辑来源分组，以及有证据的影响
规则。不得复制 Context 阶段命令，也不得手工修改生命周期托管目录。

以当前 Context Route 和构建回执报告完成情况，说明检查范围、知识新增/更新/
无变化、尚未解决的权限或保真问题，以及知识包是仅完成构建还是已经另行发布。