القائمة
当用户要求维护项目 wiki、补图谱、生成或更新 RepoWiki、维护 Understand-Anything 图谱、写 enhancement JSON、改 schema、命名、引用、更新规则、校验脚本、判断图谱完整性、派子 agent 分模块补充图谱时使用。维护入口，不负责普通 wiki 问答。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when writing, modifying, or deleting intent test specs (rules.md) for the AIjia app. Triggers from inside test-intents skill routing: "加一条意图", "改 X task 的 rules", "拆这条复合意图", "删 意图-XXX-NNN", "新建 X task".
Use when running, executing, or troubleshooting AIjia intent tests. Triggers from inside usertest-intents skill routing: "跑一下 X 这个 task", "跑 意图-XXX-NNN", "跑全部意图测试", "意图测试 FAIL 怎么处理", "tauri-pilot aijia ..." commands.
Use when the user mentions intent tests for the AIjia desktop app at any level — asking what they are, running them, or modifying their specs. Triggers include "意图测试", "usertest-intents", "AEIT", "跑意图测试", "跑一下 X 这个 task", "跑 意图-XXX-NNN", "写意图", "加一条意图", "改 X task 的 rules", "意图测试怎么用".
当用户用中文询问项目 wiki、UserWiki、仓库知识库、功能影响面、这个文件是干什么的、当前改动影响哪些模块、新人该先看什么、图谱完整了吗、如何安装或使用 Understand-Anything 时使用。日常 wiki 问答、安装、使用、影响面分析都走本 skill。
Use when adding or modifying `aijia <verb>` CLI subcommands in tauri-pilot — wraps **single atomic** DOM operations (click one button / fill one field / wait one state) so intent-test agents can compose them into multi-step flows without burning tokens on snapshot+click loops. Triggers "加 aijia 子命令", "封装 X 流程到 CLI", "tauri-pilot 加 login", "扩 aijia CLI", "封装 UI 操作".
Use when writing, modifying, or deleting intent test specs (rules.md) for the AIjia app. Triggers from inside test-intents skill routing: "加一条意图", "改 X task 的 rules", "拆这条复合意图", "删 意图-XXX-NNN", "新建 X task".
| name | wiki-maintainer |
| description | 当用户要求维护项目 wiki、补图谱、生成或更新 RepoWiki、维护 Understand-Anything 图谱、写 enhancement JSON、改 schema、命名、引用、更新规则、校验脚本、判断图谱完整性、派子 agent 分模块补充图谱时使用。维护入口，不负责普通 wiki 问答。 |
| license | Internal |
wiki-maintainer 是 lotus-app 的 wiki 维护入口。
它负责维护：
docs/repo-wiki/.understand-anything/knowledge-graph.json.understand-anything/enhancements/*.jsonscripts/apply-understand-enhancements.mjsscripts/check-repowiki.mjsscripts/run-userwiki-qa-smoke.mjsuserwiki 和 wiki-maintainer 两个 repo-local skill普通用户问答、安装、使用、功能影响面预估走 userwiki。只有要改变图谱、RepoWiki、schema、校验或 skill 本身时，才用本 skill。
references/source-policy.md。.understand-anything/enhancements/*.json：读 references/enhancement-schema.md。references/validation-rubric.md。references/subagent-workflow.md。AGENTS.md、CLAUDE.md。docs/README.md、docs/architecture-blueprint.md、docs/decisions/*.md、docs/release-playbook.md、docs/runtime-manager.md、docs/test-intents/README.md。.understand-anything/knowledge-graph.json。产品架构事实必须由当前源码或测试支撑。docs 可以说明政策、历史决策、命令和发布流程，但不能单独生成当前架构事实。
RepoWiki 页面：
docs/repo-wiki/README.mddocs/repo-wiki/index.mddocs/repo-wiki/sources.mddocs/repo-wiki/architecture-map.mddocs/repo-wiki/runtime-map.mddocs/repo-wiki/frontend-map.mddocs/repo-wiki/testing-and-commands.mddocs/repo-wiki/decision-index.mddocs/repo-wiki/coverage-manifest.mddocs/repo-wiki/writeback-queue.mddocs/repo-wiki/log.md项目 skill：
.agents/skills/userwiki/**.agents/skills/wiki-maintainer/**.claude/skills/userwiki/**.claude/skills/wiki-maintainer/**.claude/skills/ 必须镜像 .agents/skills/。
当用户要求“按 main 改动”“按 tag 排查”“从 commit 里发现重要补 wiki”时，先把 commit/tag 当作变更雷达，而不是事实本身：
确认目标分支和 tag 边界，优先看 vX..main、vX..origin/main、git diff --name-status 和 git log --first-parent。
如果 local main、origin/main 或当前 wiki 工作树分叉，必须在 writeback queue 里标出来源分支；不要在当前工作树不存在源码文件时，把它写成已合并的 current-source enhancement。
commit message 只用于分流优先级；产品/架构事实必须回到目标分支上的源码或测试，用 git show <ref>:<path>、git grep <ref> 或切到目标分支后读取。
按影响域拆分候选：存储/权限/运行时/LLM/前端/发布/测试分别进入对应 coverage domain，不要把一个 tag delta 混成泛化 changelog。
只有当目标分支源码、enhancement JSON、RepoWiki 入口、coverage/writeback/log 和校验都完成后，queue 才能从 candidate 或 enhancement-draft 升到 validated。
确认 .understand-anything/config.json 的 outputLanguage 是 zh。
读取 .understand-anything/knowledge-graph.json 的 project metadata、layers、tour。
读取 docs/repo-wiki/coverage-manifest.md 和 docs/repo-wiki/writeback-queue.md，先确认覆盖缺口和关闭标准。
如果是架构或模块增强，按模块派子 agent；不要从旧 docs 推断架构。
写当前来源 enhancement JSON 到 .understand-anything/enhancements/。
运行 node scripts/apply-understand-enhancements.mjs。
更新受影响的 RepoWiki 页面、coverage-manifest.md、writeback-queue.md，并追加 docs/repo-wiki/log.md。
运行校验：
node scripts/check-repowiki.mjs
node scripts/run-userwiki-qa-smoke.mjs --validate-only
node --input-type=module -e "import fs from 'node:fs'; import { validateGraph } from '/Users/a20250311/github/Understand-Anything/understand-anything-plugin/packages/core/dist/schema.js'; const graph=JSON.parse(fs.readFileSync('.understand-anything/knowledge-graph.json','utf8')); const result=validateGraph(graph); const bad=result.issues.filter(i=>i.level==='fatal'||i.level==='dropped'); console.log(JSON.stringify({success:result.success,issues:result.issues.length,bad:bad.length,nodes:graph.nodes.length,edges:graph.edges.length,layers:graph.layers?.length??0,tour:graph.tour?.length??0}, null, 2)); process.exit(bad.length ? 1 : 0);"
如果用户问当前工作区影响面，也可以生成或刷新 .understand-anything/diff-overlay.json。
对本项目来说，“图谱完整”默认指“可用于代码理解”：
.understand-anything/knowledge-graph.json 存在并通过 schema validation。coverage-manifest.md 与 writeback-queue.md。key_nodes、semantic_edges、architecture_findings、tour_steps。scripts/apply-understand-enhancements.mjs 可幂等运行。node scripts/check-repowiki.mjs 通过。node scripts/run-userwiki-qa-smoke.mjs --validate-only 通过。不要把“完整”主动扩展成审计系统、完整测试覆盖证明或每个函数都有 trace，除非用户明确要求。
.understand-anything/enhancements/<domain>-<chain>.json。module 用稳定 kebab-case。*-map.md。sources.md、decision-index.md、testing-and-commands.md。outputLanguage 是 zh 时写英文图谱内容。.understand-anything/enhancements/。docs/repo-wiki/log.md。coverage-manifest.md 或 writeback-queue.md。.agents 不同步 .claude。