wiki · diff
git:20261028.64702f8 to git:20261029.9b9ec16
17 added, 32 removed. Audit A to A.
---
name: wiki
- description: 阅读、初始化和维护项目 Wiki，覆盖业务能力、架构、部署环境与运维知识，检查文档结构与链接，并结合代码变更分析知识是否过期。适用于建立项目知识库、解释已有模块和同步项目文档；不替代需求决策、代码修复或发布流程。
+ description: 依据项目当前代码、配置和工程脚本阅读、生成和维护开发 Wiki，讲清架构、业务实现、部署与运维知识，并辅助检查来源、新鲜度和文档结构。不承担产品确认、代码修复或发布。
user-invocable: true
---
- # 项目知识维护
-
- 让项目知识能被定位、核实和更新。知识覆盖项目概览、业务/能力、系统架构、部署环境和运维排障，按项目适用性组织。知识内容归目标项目所有，技能提供方法、检查工具和显式复核记录工具，不要求固定语言、框架、目录或外部模型服务。
-
- ## 选择任务
-
- | 用户意图 | 执行方式 |
- |---|---|
- | read：理解项目或模块 | 先按 `references/freshness.md` 检查相关模块新鲜度，再读索引及相关文档；关键结论追溯来源，返回依据、适用版本和未知项 |
- | init：建立知识库 | 阅读 `references/initialization.md`，确定交付范围、模块和维护程度；按 `references/templates.md` 选择所需模板，实际生成并验证 |
- | maintain：更新指定知识 | 阅读 `references/knowledge-maintenance.md`，对照来源做局部修改，按 `references/content-verification.md` 核对证据范围、实际生效链与来源映射，保留人工内容和未解决分歧 |
- | check：检查知识库 | 阅读 `references/tools.md`，运行适用的结构检查；如用户要求内容核验，再抽查来源 |
- | sync：分析变更影响并同步 | 阅读 `references/change-review.md` 和 `references/freshness.md`，核对变更与知识，按授权更新或说明无需更新，项目已启用新鲜度记录时在实际复核后保存声明 |
-
- 不把每次阅读变成全库审计，也不因为编写代码就自动重建 Wiki。只读询问、检查和同步建议不隐含写入授权；用户已明确要求初始化或更新时直接完成范围内文档工作，不新增固定审批门。
+ # 项目开发知识
- 缺少 PRD、部分规则有争议或部署状态未知时，继续交付有依据的内容，局部标记缺口。发布记录、审批流程或 CI 改造只有在本次目标需要时才纳入交付；不能用一份治理建议替代已授权的文档生成。
+ 为开发人员和编码 Agent 讲清项目如何工作、如何修改。以代码、配置和工程脚本为主，解释用途、流程、条件、异常、依赖及修改影响；关键结论附来源文件，必要时定位符号。已有目录、术语、人工解释和检查约定优先。
- ## 定位与证据
+ Wiki新增文件和文件夹沿用项目现有文档的命名语言与风格，不根据本次对话语言自行翻译；`modules`、`README.md`、`reviews.json`、`wiki.config.json` 保留固定名称。已有路径不自动重命名，模板内部英文名称不决定输出文件名；命名与类型配置见 `references/templates.md`。
- - 先确定目标项目根、用户关注范围和已有知识入口。沿用项目指令及目录约定；没有约定时，为初始化选择与项目现有文档一致的位置并说明。不要把 Wiki 写进插件安装目录。
- - 初始化时评估架构、部署环境和运维排障的覆盖与适用性，相关取证方法见 `references/system-knowledge.md`；缺少线上证据时仍可记录部署方式，不推定实际上线状态。
- - 模块优先按读者需要理解的业务或对外能力划分，再与代码建立多对多映射；不直接照搬目录或按业务名称机械拆分。概览、规则、代码映射和依赖可合并或按需拆分。
- - 新建且无既有约定时，使用 `references/templates.md` 的 small 或 modular 骨架，以及技能 `assets/templates/` 内对应模板；将选择写入项目自有检查配置并显式传给检查工具。已有项目使用 project 约定，需要自动检查时声明其必需文档和章节，不自动搬迁目录或补套默认格式。
- - 重要结论按 `references/knowledge-classification.md` 区分预期约定、实现观察、运行验证和推断，并注明依据、核验方式与适用版本或环境。未知和冲突局部记录；“待确认项”只列查证后仍影响当前结论、决策或操作的具体未决问题，已知边界、未执行验证和未被要求的未来能力分别归位；整篇“部分核验”不能代替条目分类。
- - 对初始化或维护的重要正文结论按 `references/content-verification.md` 核对证据能支持的范围、操作描述的实际生效链，以及正文来源是否覆盖到本页所属模块；不以路径覆盖报告代替语义核对。
- - 对影响决策的结论保留来源、适用范围、基线和实际核验时间。阅读过文档不等于核实过事实；无法访问来源时保留未知，不刷新其核验时间。
- - 技能资源从宿主提供的技能目录定位，目标根显式传给脚本。检查命令只读；`review` 仅按显式复核声明保存项目记录，不自动更新知识或判断语义，不调用模型 API。
- - 新鲜度按配置覆盖的来源、文档和内容指纹核对。日期与无关提交不直接决定过期；缺少配置、映射、记录或来源时保留未知。检查通过只说明与记录的快照一致，复核声明真实性仍需证据。
+ ## 任务入口
- ## 交付与协作边界
+ | 任务 | 按需读取 |
+ |---|---|
+ | 阅读或解释 | 项目知识入口；已配置时先按 `references/freshness.md` 检查相关模块，再核实关键来源 |
+ | 初始化 | `references/initialization.md` 确定覆盖与模块，`references/templates.md` 选择布局 |
+ | 维护或同步 | 读取相关正文和实际代码 diff，按下方流程更新；Git比较范围见 `references/tools.md` |
+ | 机械检查 | `references/tools.md`；新鲜度、复核声明与候选检查见 `references/freshness.md` |
- 按任务返回答案、修改文件或检查结果，并说明证据基线、实际检查范围、未确认项和未执行的验证。机械检查通过仅表示其覆盖的检查通过。
+ ## 编写与复审
- 初始化还应交代一次性文档、持续维护、持续同步或强制检查门中实际完成到哪一级；持续同步应有真实首份复核记录和触发约定，强制门应有实际接入证据。脚本的 semantic: not_run 不免除 Agent 对所写结论进行语义核对的责任。
+ 1. **定范围**：读取项目指令、现有知识及相关未提交内容，确定要维护的模块和文件。实质性多模块任务在宿主可委派时按 `references/module-workflow.md` 分工编写与独立复审；运行中的子Agent合计最多3个，编写、复审及返工共用上限，由主Agent排队调度。小修正或无委派工具时自行完成，说明实际复核方式。
+ 2. **读代码、写知识**：按 `references/content-verification.md` 追真实入口、调用方和配置覆盖，直接修正错误原句、表格或步骤。已有映射时可用 `mapping --document` 直接查看来源覆盖、缺口和歧义，命令见工具参考。
+ 3. **复审与整合**：核对代码依据、遗漏条件、范围扩大及操作风险；处理有依据的发现，读回正文和 diff，统一跨模块概念与重复结论。运行项目约定检查，仅为实际核对范围保存复核记录，交付文档、关键变化与必要技术缺口。
- 需求变更由用户或需求流程决定；疑难取证可调用可用的 `research`；实现缺陷交给修复流程。Wiki 为需求、设计、实现、测试和发布提供知识输入，不自动启动这些流程，也不把自身设为每次开发的强制阶段。
+ 正文按当前实现编写，不等待PRD或产品批准；文档/注释不同则核实执行路径，必要时简注差异。测试代码不等于测试已通过，部署脚本不等于已上线。已知边界、未运行与建议在相关位置说明，待确认项只留查证后仍影响开发或本次操作的技术问题。
- 评估技能行为时使用 `references/evaluation-cases.md`；这些场景不要求日常使用时全部执行。
+ 用户授权维护时完成范围内文档，不自动修复代码、部署、读取凭据或改造CI。机械通过不证明知识语义正确；技能不常驻监听，新鲜度触发取决于项目实际接入。行为评估见 `references/evaluation-cases.md`，日常任务无需逐项执行。