wiki git:20261028.8684f63A

Immutable. This exact content never changes and is served at /api/v1/blob/822be12d42116c59.

---
name: wiki
description: 阅读、初始化和维护项目 Wiki，覆盖业务能力、架构、部署环境与运维知识，检查文档结构与链接，并结合代码变更分析知识是否过期。适用于建立项目知识库、解释已有模块和同步项目文档；不替代需求决策、代码修复或发布流程。
user-invocable: true
---

# 项目知识维护

让项目知识能被定位、核实和更新。知识覆盖项目概览、业务/能力、系统架构、部署环境和运维排障，按项目适用性组织。知识内容归目标项目所有，技能提供方法、检查工具和显式复核记录工具，不要求固定语言、框架、目录或外部模型服务。

## 选择任务

| 用户意图 | 执行方式 |
|---|---|
| read：理解项目或模块 | 先按 `references/freshness.md` 检查相关模块新鲜度，再读索引及相关文档；关键结论追溯来源，返回依据、适用版本和未知项 |
| init：建立知识库 | 阅读 `references/initialization.md`，确定交付范围、模块和维护程度；按 `references/templates.md` 选择所需模板，实际生成并验证 |
| maintain：更新指定知识 | 阅读 `references/knowledge-maintenance.md`，对照来源做局部修改，保留人工内容和未解决分歧 |
| check：检查知识库 | 阅读 `references/tools.md`，运行适用的结构检查；如用户要求内容核验，再抽查来源 |
| sync：分析变更影响并同步 | 阅读 `references/change-review.md` 和 `references/freshness.md`，核对变更与知识，按授权更新或说明无需更新，项目已启用新鲜度记录时在实际复核后保存声明 |

不把每次阅读变成全库审计，也不因为编写代码就自动重建 Wiki。只读询问、检查和同步建议不隐含写入授权；用户已明确要求初始化或更新时直接完成范围内文档工作，不新增固定审批门。

缺少 PRD、部分规则有争议或部署状态未知时，继续交付有依据的内容，局部标记缺口。发布记录、审批流程或 CI 改造只有在本次目标需要时才纳入交付；不能用一份治理建议替代已授权的文档生成。

## 定位与证据

- 先确定目标项目根、用户关注范围和已有知识入口。沿用项目指令及目录约定；没有约定时，为初始化选择与项目现有文档一致的位置并说明。不要把 Wiki 写进插件安装目录。
- 初始化时评估架构、部署环境和运维排障的覆盖与适用性，相关取证方法见 `references/system-knowledge.md`；缺少线上证据时仍可记录部署方式，不推定实际上线状态。
- 模块优先按读者需要理解的业务或对外能力划分，再与代码建立多对多映射；不直接照搬目录或按业务名称机械拆分。概览、规则、代码映射和依赖可合并或按需拆分。
- 新建且无既有约定时，使用 `references/templates.md` 的 small 或 modular 骨架，以及技能 `assets/templates/` 内对应模板；将选择写入项目自有检查配置并显式传给检查工具。已有项目使用 project 约定，需要自动检查时声明其必需文档和章节，不自动搬迁目录或补套默认格式。
- 重要结论按 `references/knowledge-classification.md` 区分预期约定、实现观察、运行验证和推断，并注明依据、核验方式与适用版本或环境。未知和冲突局部记录；整篇“部分核验”不能代替条目分类。
- 对影响决策的结论保留来源、适用范围、基线和实际核验时间。阅读过文档不等于核实过事实；无法访问来源时保留未知，不刷新其核验时间。
- 技能资源从宿主提供的技能目录定位，目标根显式传给脚本。检查命令只读；`review` 仅按显式复核声明保存项目记录，不自动更新知识或判断语义，不调用模型 API。
- 新鲜度按配置覆盖的来源、文档和内容指纹核对。日期与无关提交不直接决定过期；缺少配置、映射、记录或来源时保留未知。检查通过只说明与记录的快照一致，复核声明真实性仍需证据。

## 交付与协作边界

按任务返回答案、修改文件或检查结果，并说明证据基线、实际检查范围、未确认项和未执行的验证。机械检查通过仅表示其覆盖的检查通过。

初始化还应交代一次性文档、持续维护、持续同步或强制检查门中实际完成到哪一级；持续同步应有真实首份复核记录和触发约定，强制门应有实际接入证据。脚本的 semantic: not_run 不免除 Agent 对所写结论进行语义核对的责任。

需求变更由用户或需求流程决定；疑难取证可调用可用的 `research`；实现缺陷交给修复流程。Wiki 为需求、设计、实现、测试和发布提供知识输入，不自动启动这些流程，也不把自身设为每次开发的强制阶段。

评估技能行为时使用 `references/evaluation-cases.md`；这些场景不要求日常使用时全部执行。