用途:Wiki 是记忆层,负责持久化的知识库内容,包括笔记、研究、来源绑定、交接、召回、新鲜度与漂移;Forge 负责受跟踪的实现流程。适用于知识库根目录定位、检索、研究归档、交接、新鲜度修复和项目记忆问题。
主要能力:通过 wiki ask 检索知识,wiki search 搜索 vault(支持 --hybrid),wiki research file 归档研究,wiki handover 结束会话,wiki resume 开始会话,wiki forge next/status 获取工作流状态。
使用方式:vault 不假定为当前仓库,需通过 KNOWLEDGE_VAULT_ROOT 或 wiki config --effective --repo <path> 解析。初始化用 wiki init <project> --repo <path>,会创建 wiki.config.jsonc 并生成 AGENTS.md、CLAUDE.md 的托管定位块。项目记忆应放在 $KNOWLEDGE_VAULT_ROOT/projects/<project>/ 下,项目研究放 projects/<project>/research/。
限制:不要仅因用户提到 wiki 或 forge 就在仓库下创建 projects/、wiki/、forge/ 目录。新鲜度/修复类命令(wiki checkpoint、wiki maintain、doctor、refresh)为内部命令,由 forge next 的阶段包驱动。标记为 generated 的页面由流水线拥有,不可手工编辑。若存在 Forge phasePacket,不得用 wiki 层猜测覆盖。编辑技能文件后需运行 bun run sync:full,再运行 bun run sync:local -- --audit,然后重启代理会话。