用途:将项目前端架构与核心业务知识整理为多页面 Wiki,并在日常问答或代码变更后保持文档与代码一致,充当架构知识库的守护者。\n\n主要能力:可全量初始化 Wiki、按模块更新已有文档、解答团队成员关于模块原理与链路的疑问,以及在架构变更后联动更新文档。文档根目录固定为 .cursor/skills/wiki-generator/wiki/,所有页面必须能从 wiki/_sidebar.md 导航到,链接使用相对路径。架构/链路类文档必须含至少 1 个 Mermaid 图;任意 Markdown 文末必须包含“Sources: 资料来源:”并列出代码路径与关键行号范围。\n\n使用方式:初始化时读取 package.json、vite.config.ts 等构建配置,盘点 src/routes、src/pages、src/components、src/stores 等核心目录与入口,生成 README.md 与 _sidebar.md,复杂模块拆到二级目录。更新时先判定内容变更还是结构变更,结构变更必须同步 _sidebar.md;内容变更不强制更新导航,但需同步正文、Mermaid 与 Sources。问答时先读 Wiki 再对照最新代码,按架构原理、核心代码链路、注意事项三段式回答。本地预览命令为 pnpm wiki,脚本入口为 bash .cursor/skills/wiki-generator/scripts/serve-wiki.sh。\n\n限制与失败条件:缺少 _sidebar.md 或存在孤立页面、架构文档无 Mermaid 图、缺少 Sources 均判定失败;结构变更未更新 _sidebar.md、Sources 与实际引用代码不一致同样失败。其余细节暂未提供。
wiki-generator
写作与研究
更新于 10-15 21:35