mediawiki-skill

一个面向 AI 助手的 MediaWiki 平台技能包，遵循 Anthropic 发布的 Agent Skills 开放标准（SKILL.md + references/ + assets/），一次编写、随处运行——无需任何修改即可在 25+ 支持该标准的 AI harness 中使用：Claude Code、WorkBuddy、Cursor、Windsurf、OpenAI Codex、Gemini CLI、GitHub Copilot、OpenCode、Cline、Roo Code、Zed、Trae、Kiro、JetBrains、Qwen Code 等。

覆盖 MediaWiki 全栈知识：wikitext 标记语言、模板与解析器函数、Scribunto Lua 模块、分类与重定向、引用体系，以及MediaWiki条目的写作规范。无论你是要创建一篇MediaWiki风格的文章、编写可复用的模板，还是调试渲染异常，本技能都能提供准确、可执行的参考。

特性

• 知识细化拆分：12 个专题参考文档，按主题独立成册，需要时只查对应文件
• 全栈覆盖：从基础文本格式到 Lua 模块编程、从引用模板到分类排序键
• 权威细节：完整的 #time 格式码表、图片选项表、HTML 实体表、表达式运算符表
• 贴近实战：包含MediaWiki条目结构范式、常用模板示例（Infobox / Navbox / 引用）与常见故障排错
• 即插即用：符合 Agent Skills 规范，安装后 AI 自动识别触发场景

目录结构

mediawiki-skill/
├── LICENSE                          # MIT 许可证
├── README.md                        # 项目说明（本文件）
├── CHANGELOG.md                     # 变更日志
├── CONTRIBUTING.md                  # 贡献指南
├── .gitignore
└── mediawiki-skill/                 # 技能本体（Agent Skill）
    ├── SKILL.md                     # 技能入口：frontmatter + 快速参考
    ├── assets/
    │   └── snippets.yaml            # VS Code 兼容代码片段（88 个）
    ├── examples/                    # 优秀维基条目源码参考（持续补充）
    │   └── README.md                # 参考目录说明与使用引导
    └── references/                  # 12 个专题参考文档
        ├── text-formatting.md       # 文本格式与 HTML 实体
        ├── headings-and-lists.md    # 标题与列表
        ├── links-and-images.md      # 链接与图片
        ├── tables.md                # 表格
        ├── citations.md             # 引用与脚注
        ├── templates.md             # 模板基础与嵌入
        ├── parser-functions.md      # 解析器函数
        ├── magic-words.md           # 魔术字
        ├── lua-modules.md           # Scribunto Lua 模块
        ├── categories-and-redirects.md # 分类、重定向与讨论页
        ├── wikipedia-style.md       # MediaWiki条目风格
        └── troubleshooting.md       # 常见问题与排错

安装

方式一：npx 一键安装（推荐，需 Node.js 18+）

npx mediawiki-skill                                # 自动检测；存在多个 harness 时交互式选择
npx mediawiki-skill --all                          # 安装到所有检测到的 harness
npx mediawiki-skill --target ~/.claude/skills      # 指定安装目录
npx mediawiki-skill --force                        # 覆盖已存在的安装

• 检测到多个可用目录时，会列出编号菜单让你选择安装到哪个（支持「全部安装」）
• 检测到唯一目录时直接安装；一个都没检测到时默认装到 ~/.workbuddy/skills
• 安装器识别 Claude Code、WorkBuddy、Cursor、Codex、Gemini CLI、Windsurf、GitHub Copilot、OpenCode 等 20+ 工具的 skills 目录约定（项目级与用户级均覆盖），并优先使用跨客户端通用约定 .agents/skills/

方式二：手动复制

将 mediawiki-skill/ 目录复制到对应工具的 skills 目录即可：

# WorkBuddy：用户级安装（所有项目可用）
cp -r mediawiki-skill ~/.workbuddy/skills/

# WorkBuddy：项目级安装（仅当前项目）
cp -r mediawiki-skill <项目目录>/.workbuddy/skills/

# Claude Code
cp -r mediawiki-skill ~/.claude/skills/

兼容性（Agent Skills 开放标准）

本技能遵循 Anthropic 的 Agent Skills 开放标准，以下 AI 工具（不限于）均可直接使用，安装路径以各工具官方文档为准：

| 工具 | 项目级目录 | 用户级目录 | |---|---|---| | Claude Code | .claude/skills/ | ~/.claude/skills/ | | WorkBuddy | .workbuddy/skills/ | ~/.workbuddy/skills/ | | Cursor | .cursor/skills/ | ~/.cursor/skills/ | | Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ | | OpenAI Codex | .codex/skills/ | ~/.codex/skills/ | | Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ | | GitHub Copilot | .github/skills/ | ~/.copilot/skills/ | | OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ | | 跨客户端通用 | .agents/skills/ | ~/.agents/skills/ |

提示：放在 .agents/skills/ 下是跨客户端共享的通用约定，所有支持该标准的工具都能发现。更多工具与目录信息参见 Agent Skills 生态。

使用方式

安装完成后，直接用自然语言描述任务即可，例如：

• “帮我写一篇MediaWiki风格的条目，带信息框、章节和参考文献”
• “写一个带 #if 条件判断和 #switch 多分支的模板”
• “生成一个可排序的 wikitable，包含跨行列合并”
• “把这段 Markdown 转成 wikitext，引用用命名 ref 复用”
• “用 Lua 模块实现一个字符串处理工具”

文档导航

| 主题 | 文档 | |---|---| | 优秀条目源码参考（优先查阅） | examples/README.md | | 文本格式 / HTML 实体 / 特殊标签 | references/text-formatting.md | | 标题层级与各类列表 | references/headings-and-lists.md | | 链接、图片与画廊 | references/links-and-images.md | | 表格完整语法 | references/tables.md | | 引用与脚注体系 | references/citations.md | | 模板调用与嵌入 | references/templates.md | | 解析器函数大全 | references/parser-functions.md | | 魔术字 | references/magic-words.md | | Scribunto Lua 模块 | references/lua-modules.md | | 分类 / 重定向 / 讨论页 | references/categories-and-redirects.md | | MediaWiki条目风格 | references/wikipedia-style.md | | 常见问题与排错 | references/troubleshooting.md |

许可证

MIT © 2026 Maicarons