菜单
当用户要求「写 Pallas 插件」「给插件加命令」「cmd_perm 怎么接」「WebUI 热重载配置」 「on_command 还是 on_message」「local/plugins 怎么覆盖」「帮助图 menu_data 怎么写」 「message_scrub 要不要接」「插件放哪、路径 helper 用什么」时，优先读取本 SKILL。 面向 Pallas-Bot 主仓与 local/plugins 站点插件开发；Agent 应按章节按需加载 references，勿一次性读完全部。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | pallas-plugin-development |
| description | 当用户要求「写 Pallas 插件」「给插件加命令」「cmd_perm 怎么接」「WebUI 热重载配置」 「on_command 还是 on_message」「local/plugins 怎么覆盖」「帮助图 menu_data 怎么写」 「message_scrub 要不要接」「插件放哪、路径 helper 用什么」时，优先读取本 SKILL。 面向 Pallas-Bot 主仓与 local/plugins 站点插件开发；Agent 应按章节按需加载 references，勿一次性读完全部。 |
本 Skill 描述 Pallas-Bot 仓库约定（内核分层、cmd_perm、WebUI、多牛分片等） 章节拆在
references/；需要某专题时再读对应文件，不要把全部 references 塞进上下文。 人类贡献者也可从 develop/plugin/getting-started.md 入门。
| 章节 | 主题 | 文件 |
|---|---|---|
| 一 | 插件基础（目录、入口、公开 API、主仓 vs local） | references/01-plugin-basics.md |
| 二 | Matcher 决策树（on_command / on_message / 事件） | references/02-matchers-decision.md |
| 三 | cmd_perm 与帮助文案 | references/03-cmd-perm-and-help.md |
| 四 | WebUI 配置热重载 | references/04-webui-config.md |
| 五 | 路径、数据与资源 | references/05-paths-and-data.md |
| 六 | message_scrub 入站过滤 | references/06-message-scrub.md |
| 七 | 测试与文档自检 | references/07-tests-and-docs.md |
| 八 | 完整示例插件 checklist | references/08-golden-plugin-checklist.md |
pallas.toml + webui.json；控制台为 Pallas WebUI（/pallas/）。src/plugins/<name>/；站点定制 local/plugins/<name>/（同名时 local 优先，需 extra_plugin_dirs + 重启）。src.features.*、src.foundation.*、src.console.webui；跨插件能力不要深层 import 内核内部文件。见 一、公开 API。{插件}.{动作} 须在 metadata、permission_for_command、matcher 中完全一致。usage 不写死权限；trigger_condition 只写怎么说；权限绑 command_permission + WebUI 矩阵。get_config() / get_my_config()，勿在模块顶层缓存配置快照。{} 或 f-string，避免 "%s" 传统 logging 写法。| 文档 | 用途 |
|---|---|
| plugin/getting-started.md | 人类向最小示例 |
| plugin/structure.md | 目录拆分 |
| plugin/advanced.md | 进阶横切能力 |
| cmd_perm/README.md | 权限与 menu 细则 |
| webui/README.md | 热重载配置 |
| plugin-convention.md | 插件目录约定 |
| AGENTS.md | Agent / CI 协作约定 |