| name | maa-wiki |
| description | Route MaaFramework questions and other Maa skills to authoritative official documentation, schemas, APIs, bindings, release history, and semantic-change facts through the MaaLLMWiki catalog. Use when official Maa knowledge must be verified before designing, testing, or citing Maa ecosystem behavior. |
Maa Wiki
将 MaaFramework 相关问题和其它 Maa skill 路由到权威官方材料。它是 Maa 生态知识的导航器，不是答案仓库；最终结论必须回到原始文档、schema 或源码。
用途与边界
- 覆盖 MaaFramework 官方文档、Pipeline/schema 规范、native API、binding API、release 历史、语义变化和兼容性证据。
- 项目专用 Pipeline 配置、用户项目事实、游戏 UI 状态和未经核实的诊断结论不在本 skill 范围内。
- 本 skill 不复制、缓存或内置 MaaLLMWiki catalog；只按需读取上游 URL。
总入口
先读取 MaaLLMWiki 仓库根 README：
https://raw.githubusercontent.com/Windsland52/MaaLLMWiki/main/README.md
README 描述仓库布局和生成索引层级。不要跳过总入口直接猜测文件路径。
导航协议
- 从总入口 README 开始，理解
sources/、generated/ 和 schemas/ 的用途。
- 需要找文件时，使用 GitHub tree/API 或 raw URL 模式自行定位路径。
- 阅读 Markdown 中的相对链接时，把
./xxx/index.md 等链接转换成 raw.githubusercontent.com/Windsland52/MaaLLMWiki/main/... 后读取。
- 优先读取索引文件里的 pinned commit/revision，再回到对应的 MaaFramework 或 binding 仓库原始路径。
- 所有读取都是临时参考；不要把 catalog 内容写进用户项目。
引用纪律
- catalog 索引只说明“去哪里找”，不能作为最终权威。
- 引用官方行为、schema、API 或语义变化时，必须附上原始来源 URL 或 revision。
- 只能贴必要片段，不要大规模复制上游内容。
- URL 不可达、路径不存在或 revision 不明确时，把相关事实标记为“未验证”，并说明缺少的来源，不得凭模型记忆补全。
与其它 Maa skill 协作
maa-workflow-build：任务契约、设计或验收依赖官方事实时，通过 $maa-wiki 核对原始来源。maa-pipeline-guide、maa-pipeline-testing、maa-project-create：涉及官方协议、schema、API、版本或兼容性判断时，可先调用本 skill。- 普通项目文件扫描、已有项目内 Pipeline 编辑等低风险工作不强制先读 wiki；按需引用，避免为每个任务增加网络依赖。
失败处理
- 网络不可用时，允许复用当前会话已读过的原始来源，但不得把未读取的 catalog 内容当成已知事实。
- 导航失败后先报告失败的 URL 和已确认的路径；再决定是否继续其它技能工作流。
- 无法验证官方事实时，明确列出未验证项和需要的原始来源，不代替用户完成核对。
