diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index bb98ff06c..b08a75d2f 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -1,7 +1,7 @@ { "name": "eapil-skill-market", "interface": { - "displayName": "EAPIL Skill Market" + "displayName": "EAPIL 技能市场" }, "plugins": [ { @@ -14,7 +14,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Productivity" + "category": "文档处理" }, { "name": "eapil-pptx", @@ -26,7 +26,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Productivity" + "category": "文档处理" }, { "name": "eapil-xlsx", @@ -38,127 +38,19 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Data \u0026 Analytics" + "category": "数据分析" }, { - "name": "eapil-threejs-animation", + "name": "eapil-threejs", "source": { "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-animation" + "path": "./plugins/codex/plugins/eapil-threejs" }, "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-fundamentals", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-fundamentals" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-geometry", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-geometry" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-interaction", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-interaction" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-lighting", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-lighting" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-loaders", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-loaders" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-materials", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-materials" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-postprocessing", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-postprocessing" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-shaders", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-shaders" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-textures", - "source": { - "source": "local", - "path": "./plugins/codex/plugins/eapil-threejs-textures" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" + "category": "开发工具" }, { "name": "superpowers", @@ -170,7 +62,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Developer Tools" + "category": "开发工具" }, { "name": "ui-ux-pro-max", @@ -182,7 +74,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Design" + "category": "设计" } ] } diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..9fcb6093c --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,130 @@ +# EAPIL Skill Market 维护指南 + +本仓库是 Codex 自定义插件市场，面向中文用户分发可选安装的技能包。后续维护时，以本文件作为仓库级工作约定。 + +## 关键原则 + +- 插件是分发单位，skill 是插件内部的能力单位。一个插件可以包含多个 skill。 +- 市场中的插件默认使用 `policy.installation: "AVAILABLE"`，不要改成 `INSTALLED_BY_DEFAULT`，除非明确要求所有用户默认安装。 +- 面向用户展示的名称、说明、分类可以使用中文。插件 ID、skill `name`、目录名保持英文 kebab-case，避免破坏安装标识和脚本路径。 +- Codex 对同名 skill 不做合并；用户目录、仓库目录、插件目录里如果出现同名 skill，它们可能同时出现在选择器里。维护时尽量使用清晰、稳定的 skill 名称，避免让用户看到多个无法区分的同名入口。 +- 第三方插件生成目录是同步产物。不要为了本地化直接手改 `plugins/codex/plugins/superpowers` 或 `plugins/codex/plugins/ui-ux-pro-max` 里的生成内容；应改 `config/external-sources.json` 的覆盖配置，再重新同步。 + +## 当前结构 + +市场入口： + +- `.agents/plugins/marketplace.json`：仓库根市场入口，适合 Git 市场直接添加。 +- `plugins/codex/.agents/plugins/marketplace.json`：兼容稀疏路径安装的嵌套市场入口。 + +插件目录： + +- `plugins/codex/plugins/eapil-pdf` +- `plugins/codex/plugins/eapil-pptx` +- `plugins/codex/plugins/eapil-xlsx` +- `plugins/codex/plugins/eapil-threejs` +- `plugins/codex/plugins/superpowers` +- `plugins/codex/plugins/ui-ux-pro-max` + +Three.js 相关 skill 统一放在 `eapil-threejs` 一个插件内，不再拆成多个 `eapil-threejs-*` 插件。这样用户只需要安装一个 Three.js 技能包，安装后 Codex 仍然可以在包内按具体 skill 选择场景、材质、灯光、交互、动画等工作流。 + +## 第三方 skill 引入流程 + +第三方来源统一配置在 `config/external-sources.json`： + +- `adapter: "codex-plugin"`：上游本身已经是 Codex plugin，例如 `obra/superpowers`。 +- `adapter: "claude-skill"`：上游是 Claude-style skill，需要转换成 Codex plugin，例如 `nextlevelbuilder/ui-ux-pro-max-skill`。 + +同步命令： + +```powershell +powershell -ExecutionPolicy Bypass -File .\scripts\sync_external_plugins.ps1 +``` + +如果本地访问 GitHub 不稳定： + +```powershell +powershell -ExecutionPolicy Bypass -File .\scripts\sync_external_plugins.ps1 -Proxy http://127.0.0.1:18085 +``` + +只同步某个来源： + +```powershell +powershell -ExecutionPolicy Bypass -File .\scripts\sync_external_plugins.ps1 -Only ui-ux-pro-max -Proxy http://127.0.0.1:18085 +``` + +第三方本地化规则： + +- 用 `manifestOverrides` 覆盖插件展示层字段，例如 `description`、`interface.displayName`、`interface.shortDescription`、`interface.category`、`interface.defaultPrompt`。 +- 用 `skillDescriptions` 覆盖复制后 `SKILL.md` frontmatter 的 `description`。 +- 覆盖配置会在每次同步后自动应用，因此不会阻碍后续拉取上游更新。 +- `config/external-sources.lock.json` 记录上游 commit 和同步时间，不要手工编造。 + +## 自制 skill 添加流程 + +新增自制 skill 时优先判断分发粒度： + +- 如果它是独立领域能力，创建一个新插件，例如 `eapil-pdf`。 +- 如果它是某个已有领域的一部分，放进已有插件的 `skills/` 下，例如 Three.js 的新增材质、加载、调试类能力放进 `eapil-threejs`。 + +自制插件最低结构： + +```text +plugins/codex/plugins// + .codex-plugin/plugin.json + skills//SKILL.md +``` + +新增自制插件后必须同时更新两个 marketplace： + +- `.agents/plugins/marketplace.json` +- `plugins/codex/.agents/plugins/marketplace.json` + +两个 marketplace 的插件列表、分类和安装策略应保持一致；只有 `source.path` 前缀不同。 + +自制插件中文展示建议： + +- `plugin.json` 的 `description`、`interface.shortDescription`、`interface.longDescription`、`interface.category` 可以使用中文。 +- `SKILL.md` frontmatter 的 `description` 可以使用中文，也可以保留必要英文关键词帮助英文触发。 +- `name` 字段保持英文 kebab-case。 + +## 验证 + +每次改动后至少运行： + +```powershell +python scripts\validate_marketplace.py +``` + +涉及单个插件结构时运行： + +```powershell +python C:\Users\cmx27\.codex\skills\.system\plugin-creator\scripts\validate_plugin.py plugins\codex\plugins\ +``` + +需要验证 Codex 安装行为时： + +```powershell +codex plugin marketplace add . --json +codex plugin list --marketplace eapil-skill-market --available --json +codex plugin add @eapil-skill-market --json +codex plugin remove @eapil-skill-market --json +``` + +本地测试安装后记得移除测试插件，避免 Codex Desktop 显示为已启用而误判为市场默认安装。 + +## 提交要求 + +提交信息应说明为什么改，而不只是列出改了什么。推荐包含： + +```text + + +Constraint: <约束> +Rejected: <拒绝的方案> | <原因> +Confidence: +Scope-risk: +Directive: <后续维护提醒> +Tested: <已验证> +Not-tested: <未验证> +``` diff --git a/README.md b/README.md index 9ddf775cd..2f6b4c7b1 100644 --- a/README.md +++ b/README.md @@ -47,16 +47,7 @@ Start a new Codex thread after installing so the new skills are loaded into cont - `eapil-pdf` - `eapil-pptx` - `eapil-xlsx` -- `eapil-threejs-animation` -- `eapil-threejs-fundamentals` -- `eapil-threejs-geometry` -- `eapil-threejs-interaction` -- `eapil-threejs-lighting` -- `eapil-threejs-loaders` -- `eapil-threejs-materials` -- `eapil-threejs-postprocessing` -- `eapil-threejs-shaders` -- `eapil-threejs-textures` +- `eapil-threejs` - `superpowers` - `ui-ux-pro-max` @@ -91,6 +82,8 @@ The sync script currently supports: - `codex-plugin`: mirrors an upstream Codex plugin repo, used for `obra/superpowers`. - `claude-skill`: converts one Claude-style skill directory into a Codex plugin, used for `nextlevelbuilder/ui-ux-pro-max-skill`. +Use `manifestOverrides` and `skillDescriptions` in `config/external-sources.json` for local Chinese UI text and skill descriptions. These overlays are applied after each upstream sync, so do not edit generated third-party plugin files directly for localization. + After sync, validate the marketplace: ```powershell @@ -111,9 +104,11 @@ plugins/codex/ plugins/eapil-xlsx/ .codex-plugin/plugin.json skills/xlsx/ - plugins/eapil-threejs-fundamentals/ + plugins/eapil-threejs/ .codex-plugin/plugin.json skills/threejs-fundamentals/ + skills/threejs-materials/ + skills/threejs-shaders/ plugins/superpowers/ .codex-plugin/plugin.json skills/ diff --git a/config/external-sources.json b/config/external-sources.json index 170ffa158..793477a27 100644 --- a/config/external-sources.json +++ b/config/external-sources.json @@ -6,7 +6,7 @@ "ref": "main", "adapter": "codex-plugin", "pluginName": "superpowers", - "category": "Developer Tools", + "category": "开发工具", "sourcePath": ".", "include": [ ".codex-plugin", @@ -15,7 +15,36 @@ "README.md", "LICENSE", "CODE_OF_CONDUCT.md" - ] + ], + "manifestOverrides": { + "description": "面向编码 Agent 的规划、TDD、调试、代码评审和交付工作流集合。", + "interface": { + "displayName": "Superpowers", + "shortDescription": "规划、TDD、调试、代码评审和交付工作流。", + "longDescription": "Superpowers 提供面向编码 Agent 的结构化工作流，覆盖需求澄清、计划编写、测试驱动开发、系统化调试、并行执行、代码评审和交付收尾。", + "category": "开发工具", + "defaultPrompt": [ + "使用 Superpowers 帮我规划这个开发任务。", + "使用 Superpowers 帮我系统调试这个问题。" + ] + } + }, + "skillDescriptions": { + "brainstorming": "在开始创造性工作前澄清意图、约束和可行方向；适合功能设计、组件设计和行为变更。", + "dispatching-parallel-agents": "将两个或更多互不依赖的子任务分派给并行 Agent，以提升吞吐并保持边界清晰。", + "executing-plans": "按已经写好的实现计划逐步执行，并在关键节点进行检查和复核。", + "finishing-a-development-branch": "实现完成且验证通过后，用于判断如何整理、提交和集成开发分支。", + "receiving-code-review": "处理代码评审反馈时使用，先理解反馈和技术依据，再决定是否修改。", + "requesting-code-review": "完成较大改动后请求代码评审，重点检查需求满足、风险、测试和回归。", + "subagent-driven-development": "按计划把独立实现任务交给子 Agent，并由主 Agent 负责整合和验证。", + "systematic-debugging": "遇到 bug、测试失败或异常行为时使用，通过复现、定位根因和验证修复来调试。", + "test-driven-development": "实现功能或修复缺陷前使用，先写失败测试，再实现最小改动并重构。", + "using-git-worktrees": "开始需要隔离的功能开发时使用，通过 git worktree 建立独立工作区。", + "using-superpowers": "开始对话时了解如何发现和调用 Superpowers 技能。", + "verification-before-completion": "在声称任务完成、修复成功或测试通过前使用，确保有实际验证证据。", + "writing-plans": "在动手实现前编写多步骤计划，明确目标、约束、文件范围和验证方式。", + "writing-skills": "创建、修改或验证 Agent skill 时使用，确保 skill 可触发、可维护、可测试。" + } }, { "id": "ui-ux-pro-max", @@ -23,10 +52,26 @@ "ref": "main", "adapter": "claude-skill", "pluginName": "ui-ux-pro-max", - "category": "Design", + "category": "设计", "skillPath": ".claude/skills/ui-ux-pro-max", "metadataPath": "skill.json", "brandColor": "#7C3AED", + "manifestOverrides": { + "description": "面向界面设计、视觉风格、配色、字体、可访问性和前端技术栈的 UI/UX 设计智能库。", + "interface": { + "displayName": "UI/UX Pro Max", + "shortDescription": "UI/UX 设计智能库，覆盖风格、配色、字体、可访问性、图表和前端技术栈。", + "longDescription": "UI/UX Pro Max 提供可搜索的设计知识库，覆盖 UI 风格、配色、字体搭配、UX 指南、图表类型和多种前端技术栈，用于辅助中文用户完成产品界面设计和前端实现决策。", + "category": "设计", + "defaultPrompt": [ + "使用 UI/UX Pro Max 帮我设计这个界面。", + "使用 UI/UX Pro Max 帮我优化这个产品体验。" + ] + } + }, + "skillDescriptions": { + "ui-ux-pro-max": "用于界面设计、视觉风格、配色、字体、可访问性、图表和前端技术栈选择的 UI/UX 设计智能库。" + }, "materializePaths": [ { "source": "src/ui-ux-pro-max/data", diff --git a/plugins/codex/.agents/plugins/marketplace.json b/plugins/codex/.agents/plugins/marketplace.json index c6ca30415..64d729c11 100644 --- a/plugins/codex/.agents/plugins/marketplace.json +++ b/plugins/codex/.agents/plugins/marketplace.json @@ -1,7 +1,7 @@ { "name": "eapil-skill-market", "interface": { - "displayName": "EAPIL Skill Market" + "displayName": "EAPIL 技能市场" }, "plugins": [ { @@ -14,7 +14,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Productivity" + "category": "文档处理" }, { "name": "eapil-pptx", @@ -26,7 +26,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Productivity" + "category": "文档处理" }, { "name": "eapil-xlsx", @@ -38,127 +38,19 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Data \u0026 Analytics" + "category": "数据分析" }, { - "name": "eapil-threejs-animation", + "name": "eapil-threejs", "source": { "source": "local", - "path": "./plugins/eapil-threejs-animation" + "path": "./plugins/eapil-threejs" }, "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-fundamentals", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-fundamentals" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-geometry", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-geometry" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-interaction", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-interaction" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-lighting", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-lighting" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-loaders", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-loaders" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-materials", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-materials" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-postprocessing", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-postprocessing" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-shaders", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-shaders" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" - }, - { - "name": "eapil-threejs-textures", - "source": { - "source": "local", - "path": "./plugins/eapil-threejs-textures" - }, - "policy": { - "installation": "AVAILABLE", - "authentication": "ON_INSTALL" - }, - "category": "Developer Tools" + "category": "开发工具" }, { "name": "superpowers", @@ -170,7 +62,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Developer Tools" + "category": "开发工具" }, { "name": "ui-ux-pro-max", @@ -182,7 +74,7 @@ "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, - "category": "Design" + "category": "设计" } ] } diff --git a/plugins/codex/plugins/eapil-pdf/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-pdf/.codex-plugin/plugin.json index 10c385612..d3034b68b 100644 --- a/plugins/codex/plugins/eapil-pdf/.codex-plugin/plugin.json +++ b/plugins/codex/plugins/eapil-pdf/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "eapil-pdf", "version": "0.1.0", - "description": "EAPIL PDF provides Codex guidance and helper scripts for PDF extraction, generation, merging, splitting, rendering, and fillable form workflows.", + "description": "EAPIL PDF 提供 PDF 提取、生成、合并、拆分、渲染和表单填写相关的 Codex 工作流。", "author": { "name": "EAPIL", "url": "https://git.playones.com/arechen/EapilSkillMarket" @@ -17,18 +17,18 @@ "skills": "./skills/", "interface": { "displayName": "EAPIL PDF", - "shortDescription": "PDF processing, extraction, generation, and form workflows.", - "longDescription": "EAPIL PDF provides Codex guidance and helper scripts for PDF extraction, generation, merging, splitting, rendering, and fillable form workflows.", + "shortDescription": "PDF 处理、内容提取、文档生成和表单填写工作流。", + "longDescription": "EAPIL PDF 提供面向 PDF 文档的 Codex 工作流，覆盖文本和表格提取、PDF 生成、合并拆分、页面渲染、可填写表单处理以及中文/CJK 文档场景。", "developerName": "EAPIL", - "category": "Productivity", + "category": "文档处理", "capabilities": [ "Read", "Write" ], "defaultPrompt": [ - "Use EAPIL PDF to inspect this document.", - "Fill this PDF form with EAPIL PDF.", - "Extract tables from this PDF." + "使用 EAPIL PDF 检查这个文档。", + "使用 EAPIL PDF 填写这个 PDF 表单。", + "使用 EAPIL PDF 提取这个 PDF 的表格。" ], "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", diff --git a/plugins/codex/plugins/eapil-pdf/skills/pdf/SKILL.md b/plugins/codex/plugins/eapil-pdf/skills/pdf/SKILL.md index b65c5f1ab..be0e93ba5 100644 --- a/plugins/codex/plugins/eapil-pdf/skills/pdf/SKILL.md +++ b/plugins/codex/plugins/eapil-pdf/skills/pdf/SKILL.md @@ -1,6 +1,6 @@ --- name: pdf -description: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. Use when Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale, especially on Windows and with Chinese/CJK text. +description: "PDF 处理工具包，用于文本和表格提取、PDF 生成、合并拆分、页面渲染、表单填写，以及中文/CJK 文档处理。" license: Proprietary. LICENSE.txt has complete terms --- diff --git a/plugins/codex/plugins/eapil-pptx/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-pptx/.codex-plugin/plugin.json index f6ccb024e..4e38b65b0 100644 --- a/plugins/codex/plugins/eapil-pptx/.codex-plugin/plugin.json +++ b/plugins/codex/plugins/eapil-pptx/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "eapil-pptx", "version": "0.1.0", - "description": "EAPIL PPTX provides Codex guidance and helper scripts for creating, editing, inspecting, validating, and transforming PowerPoint presentation files.", + "description": "EAPIL PPTX 提供 PowerPoint/PPTX 创建、编辑、检查、验证和 OOXML 转换相关的 Codex 工作流。", "author": { "name": "EAPIL", "url": "https://git.playones.com/arechen/EapilSkillMarket" @@ -17,18 +17,18 @@ "skills": "./skills/", "interface": { "displayName": "EAPIL PPTX", - "shortDescription": "PowerPoint and OOXML presentation workflows.", - "longDescription": "EAPIL PPTX provides Codex guidance and helper scripts for creating, editing, inspecting, validating, and transforming PowerPoint presentation files.", + "shortDescription": "PowerPoint/PPTX 创建、编辑、检查和 OOXML 工作流。", + "longDescription": "EAPIL PPTX 提供面向演示文稿的 Codex 工作流，覆盖 PPTX 创建、内容编辑、版式处理、结构检查、OOXML 分析、批注和讲稿等任务。", "developerName": "EAPIL", - "category": "Productivity", + "category": "文档处理", "capabilities": [ "Read", "Write" ], "defaultPrompt": [ - "Use EAPIL PPTX to edit this deck.", - "Create a presentation with EAPIL PPTX.", - "Inspect this PPTX structure." + "使用 EAPIL PPTX 编辑这个演示文稿。", + "使用 EAPIL PPTX 创建一个演示文稿。", + "使用 EAPIL PPTX 检查这个 PPTX 结构。" ], "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", diff --git a/plugins/codex/plugins/eapil-pptx/skills/pptx/SKILL.md b/plugins/codex/plugins/eapil-pptx/skills/pptx/SKILL.md index ff0ec1026..368639141 100644 --- a/plugins/codex/plugins/eapil-pptx/skills/pptx/SKILL.md +++ b/plugins/codex/plugins/eapil-pptx/skills/pptx/SKILL.md @@ -1,6 +1,6 @@ --- name: pptx -description: "Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks" +description: "PPTX/PowerPoint 创建、编辑和分析工具，用于新建演示文稿、修改内容、处理版式、添加批注或讲稿，以及检查 OOXML 结构。" --- # PPTX creation, editing, and analysis diff --git a/plugins/codex/plugins/eapil-threejs-animation/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-animation/.codex-plugin/plugin.json deleted file mode 100644 index daf57e3e1..000000000 --- a/plugins/codex/plugins/eapil-threejs-animation/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-animation", - "version": "0.1.0", - "description": "EAPIL Three.js Animation provides Codex guidance for animation loops, timing, motion, transitions, and interactive scene behavior in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-animation", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Animation", - "shortDescription": "Three.js animation patterns and timing guidance.", - "longDescription": "EAPIL Three.js Animation provides Codex guidance for animation loops, timing, motion, transitions, and interactive scene behavior in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Animation for this scene.", - "Animate this Three.js object.", - "Improve this render loop." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-fundamentals/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-fundamentals/.codex-plugin/plugin.json deleted file mode 100644 index 067eec158..000000000 --- a/plugins/codex/plugins/eapil-threejs-fundamentals/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-fundamentals", - "version": "0.1.0", - "description": "EAPIL Three.js Fundamentals provides Codex guidance for core Three.js setup, scene structure, cameras, renderers, coordinate systems, and baseline architecture.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-fundamentals", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Fundamentals", - "shortDescription": "Core Three.js scene, camera, renderer, and setup guidance.", - "longDescription": "EAPIL Three.js Fundamentals provides Codex guidance for core Three.js setup, scene structure, cameras, renderers, coordinate systems, and baseline architecture.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Fundamentals.", - "Set up a Three.js scene.", - "Review this Three.js structure." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-geometry/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-geometry/.codex-plugin/plugin.json deleted file mode 100644 index 9ead94be7..000000000 --- a/plugins/codex/plugins/eapil-threejs-geometry/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-geometry", - "version": "0.1.0", - "description": "EAPIL Three.js Geometry provides Codex guidance for geometry creation, mesh composition, buffer geometry, primitives, and spatial modeling in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-geometry", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Geometry", - "shortDescription": "Three.js geometry, meshes, and shape construction guidance.", - "longDescription": "EAPIL Three.js Geometry provides Codex guidance for geometry creation, mesh composition, buffer geometry, primitives, and spatial modeling in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Geometry.", - "Build this geometry in Three.js.", - "Fix this mesh construction." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-interaction/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-interaction/.codex-plugin/plugin.json deleted file mode 100644 index 0ec917178..000000000 --- a/plugins/codex/plugins/eapil-threejs-interaction/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-interaction", - "version": "0.1.0", - "description": "EAPIL Three.js Interaction provides Codex guidance for controls, raycasting, pointer events, selection, drag behavior, and browser interaction patterns in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-interaction", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Interaction", - "shortDescription": "Three.js controls, picking, pointer, and UI interaction guidance.", - "longDescription": "EAPIL Three.js Interaction provides Codex guidance for controls, raycasting, pointer events, selection, drag behavior, and browser interaction patterns in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Interaction.", - "Add object picking.", - "Debug pointer controls." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-lighting/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-lighting/.codex-plugin/plugin.json deleted file mode 100644 index 94f23018a..000000000 --- a/plugins/codex/plugins/eapil-threejs-lighting/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-lighting", - "version": "0.1.0", - "description": "EAPIL Three.js Lighting provides Codex guidance for light types, shadow configuration, environment lighting, tone mapping, and visual balance in Three.js scenes.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-lighting", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Lighting", - "shortDescription": "Three.js lighting, shadows, and scene illumination guidance.", - "longDescription": "EAPIL Three.js Lighting provides Codex guidance for light types, shadow configuration, environment lighting, tone mapping, and visual balance in Three.js scenes.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Lighting.", - "Improve scene lighting.", - "Fix shadows in Three.js." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-loaders/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-loaders/.codex-plugin/plugin.json deleted file mode 100644 index 6b6034d68..000000000 --- a/plugins/codex/plugins/eapil-threejs-loaders/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-loaders", - "version": "0.1.0", - "description": "EAPIL Three.js Loaders provides Codex guidance for GLTF and other asset loaders, texture/model import, async loading, and asset pipeline concerns in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-loaders", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Loaders", - "shortDescription": "Three.js asset loading, model import, and pipeline guidance.", - "longDescription": "EAPIL Three.js Loaders provides Codex guidance for GLTF and other asset loaders, texture/model import, async loading, and asset pipeline concerns in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Loaders.", - "Load this GLTF model.", - "Debug Three.js assets." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-materials/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-materials/.codex-plugin/plugin.json deleted file mode 100644 index 0ed205d3d..000000000 --- a/plugins/codex/plugins/eapil-threejs-materials/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-materials", - "version": "0.1.0", - "description": "EAPIL Three.js Materials provides Codex guidance for material selection, PBR settings, texture usage, transparency, and surface appearance in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-materials", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Materials", - "shortDescription": "Three.js materials, textures, and surface appearance guidance.", - "longDescription": "EAPIL Three.js Materials provides Codex guidance for material selection, PBR settings, texture usage, transparency, and surface appearance in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Materials.", - "Improve these materials.", - "Fix texture appearance." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-postprocessing/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-postprocessing/.codex-plugin/plugin.json deleted file mode 100644 index 3d71348a6..000000000 --- a/plugins/codex/plugins/eapil-threejs-postprocessing/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-postprocessing", - "version": "0.1.0", - "description": "EAPIL Three.js Postprocessing provides Codex guidance for EffectComposer, render passes, bloom, outlines, antialiasing, color grading, and postprocessing performance.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-postprocessing", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Postprocessing", - "shortDescription": "Three.js postprocessing passes and visual effects guidance.", - "longDescription": "EAPIL Three.js Postprocessing provides Codex guidance for EffectComposer, render passes, bloom, outlines, antialiasing, color grading, and postprocessing performance.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Postprocessing.", - "Add bloom to this scene.", - "Debug EffectComposer." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-shaders/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-shaders/.codex-plugin/plugin.json deleted file mode 100644 index 4d848210a..000000000 --- a/plugins/codex/plugins/eapil-threejs-shaders/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-shaders", - "version": "0.1.0", - "description": "EAPIL Three.js Shaders provides Codex guidance for ShaderMaterial, uniforms, attributes, GLSL patterns, custom effects, and shader debugging in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-shaders", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Shaders", - "shortDescription": "Three.js shader material and GLSL guidance.", - "longDescription": "EAPIL Three.js Shaders provides Codex guidance for ShaderMaterial, uniforms, attributes, GLSL patterns, custom effects, and shader debugging in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Shaders.", - "Write a custom shader.", - "Debug this GLSL." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs-textures/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs-textures/.codex-plugin/plugin.json deleted file mode 100644 index dfc3cff41..000000000 --- a/plugins/codex/plugins/eapil-threejs-textures/.codex-plugin/plugin.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "name": "eapil-threejs-textures", - "version": "0.1.0", - "description": "EAPIL Three.js Textures provides Codex guidance for texture loading, UV mapping, color space, compression, filtering, wrapping, and performance in Three.js.", - "author": { - "name": "EAPIL", - "url": "https://git.playones.com/arechen/EapilSkillMarket" - }, - "homepage": "https://git.playones.com/arechen/EapilSkillMarket", - "repository": "https://git.playones.com/arechen/EapilSkillMarket", - "license": "Proprietary", - "keywords": [ - "eapil", - "threejs-textures", - "codex-skill" - ], - "skills": "./skills/", - "interface": { - "displayName": "EAPIL Three.js Textures", - "shortDescription": "Three.js texture loading, mapping, color space, and optimization guidance.", - "longDescription": "EAPIL Three.js Textures provides Codex guidance for texture loading, UV mapping, color space, compression, filtering, wrapping, and performance in Three.js.", - "developerName": "EAPIL", - "category": "Developer Tools", - "capabilities": [ - "Read", - "Write" - ], - "defaultPrompt": [ - "Use EAPIL Three.js Textures.", - "Fix texture mapping.", - "Optimize Three.js textures." - ], - "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", - "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", - "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", - "brandColor": "#2563EB", - "screenshots": [] - } -} diff --git a/plugins/codex/plugins/eapil-threejs/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-threejs/.codex-plugin/plugin.json new file mode 100644 index 000000000..471ec217a --- /dev/null +++ b/plugins/codex/plugins/eapil-threejs/.codex-plugin/plugin.json @@ -0,0 +1,40 @@ +{ + "name": "eapil-threejs", + "version": "0.1.0", + "description": "EAPIL Three.js 提供面向 3D 场景、几何体、材质、纹理、灯光、加载器、交互、动画、后处理和着色器的 Codex 技能集合。", + "author": { + "name": "EAPIL", + "url": "https://git.playones.com/arechen/EapilSkillMarket" + }, + "homepage": "https://git.playones.com/arechen/EapilSkillMarket", + "repository": "https://git.playones.com/arechen/EapilSkillMarket", + "license": "Proprietary", + "keywords": [ + "eapil", + "threejs", + "3d", + "codex-skill" + ], + "skills": "./skills/", + "interface": { + "displayName": "EAPIL Three.js", + "shortDescription": "Three.js 3D 开发技能包，覆盖场景、材质、纹理、灯光、加载、交互、动画、后处理和着色器。", + "longDescription": "EAPIL Three.js 提供面向 Three.js 项目的技能集合，帮助 Codex 在 3D 场景搭建、几何体、材质、纹理、灯光、加载器、交互、动画、后处理和自定义着色器任务中选择合适的工作流。", + "developerName": "EAPIL", + "category": "开发工具", + "capabilities": [ + "Read", + "Write" + ], + "defaultPrompt": [ + "使用 EAPIL Three.js 帮我实现这个 3D 场景。", + "使用 EAPIL Three.js 检查这个 Three.js 项目。", + "使用 EAPIL Three.js 优化这个 WebGL 效果。" + ], + "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", + "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", + "termsOfServiceURL": "https://git.playones.com/arechen/EapilSkillMarket", + "brandColor": "#2563EB", + "screenshots": [] + } +} diff --git a/plugins/codex/plugins/eapil-threejs-animation/skills/threejs-animation/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-animation/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-animation/skills/threejs-animation/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-animation/SKILL.md index 91742cede..b0b7b6461 100644 --- a/plugins/codex/plugins/eapil-threejs-animation/skills/threejs-animation/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-animation/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-animation -description: Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations. +description: "Three.js 动画处理，用于关键帧、骨骼动画、morph targets、动画混合、GLTF 动画播放和程序化运动。" --- # Three.js Animation diff --git a/plugins/codex/plugins/eapil-threejs-fundamentals/skills/threejs-fundamentals/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-fundamentals/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-fundamentals/skills/threejs-fundamentals/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-fundamentals/SKILL.md index 21b634124..9c911ec22 100644 --- a/plugins/codex/plugins/eapil-threejs-fundamentals/skills/threejs-fundamentals/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-fundamentals/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-fundamentals -description: Three.js scene setup, cameras, renderer, Object3D hierarchy, coordinate systems. Use when setting up 3D scenes, creating cameras, configuring renderers, managing object hierarchies, or working with transforms. +description: "Three.js 基础场景搭建，用于 scene、camera、renderer、Object3D 层级、坐标系、变换和渲染循环。" --- # Three.js Fundamentals diff --git a/plugins/codex/plugins/eapil-threejs-geometry/skills/threejs-geometry/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-geometry/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-geometry/skills/threejs-geometry/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-geometry/SKILL.md index e077e2d78..72a6d18e7 100644 --- a/plugins/codex/plugins/eapil-threejs-geometry/skills/threejs-geometry/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-geometry/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-geometry -description: Three.js geometry creation - built-in shapes, BufferGeometry, custom geometry, instancing. Use when creating 3D shapes, working with vertices, building custom meshes, or optimizing with instanced rendering. +description: "Three.js 几何体创建，用于内置几何体、BufferGeometry、自定义顶点、网格构建和 instanced rendering 优化。" --- # Three.js Geometry diff --git a/plugins/codex/plugins/eapil-threejs-interaction/skills/threejs-interaction/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-interaction/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-interaction/skills/threejs-interaction/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-interaction/SKILL.md index 9c93424ee..34b03a782 100644 --- a/plugins/codex/plugins/eapil-threejs-interaction/skills/threejs-interaction/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-interaction/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-interaction -description: Three.js interaction - raycasting, controls, mouse/touch input, object selection. Use when handling user input, implementing click detection, adding camera controls, or creating interactive 3D experiences. +description: "Three.js 交互处理，用于 raycasting、鼠标/触摸输入、对象选择、相机控制和交互式 3D 体验。" --- # Three.js Interaction diff --git a/plugins/codex/plugins/eapil-threejs-lighting/skills/threejs-lighting/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-lighting/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-lighting/skills/threejs-lighting/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-lighting/SKILL.md index 575cb0c47..8aa386307 100644 --- a/plugins/codex/plugins/eapil-threejs-lighting/skills/threejs-lighting/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-lighting/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-lighting -description: Three.js lighting - light types, shadows, environment lighting. Use when adding lights, configuring shadows, setting up IBL, or optimizing lighting performance. +description: "Three.js 灯光处理，用于光源类型、阴影、环境光、IBL 设置和灯光性能优化。" --- # Three.js Lighting diff --git a/plugins/codex/plugins/eapil-threejs-loaders/skills/threejs-loaders/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-loaders/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-loaders/skills/threejs-loaders/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-loaders/SKILL.md index 4754a7aaa..68a03ab87 100644 --- a/plugins/codex/plugins/eapil-threejs-loaders/skills/threejs-loaders/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-loaders/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-loaders -description: Three.js asset loading - GLTF, textures, images, models, async patterns. Use when loading 3D models, textures, HDR environments, or managing loading progress. +description: "Three.js 资源加载，用于 GLTF、模型、图片、纹理、HDR 环境、异步加载和进度管理。" --- # Three.js Loaders diff --git a/plugins/codex/plugins/eapil-threejs-materials/skills/threejs-materials/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-materials/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-materials/skills/threejs-materials/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-materials/SKILL.md index 4731f2826..7c02ef32e 100644 --- a/plugins/codex/plugins/eapil-threejs-materials/skills/threejs-materials/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-materials/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-materials -description: Three.js materials - PBR, basic, phong, shader materials, material properties. Use when styling meshes, working with textures, creating custom shaders, or optimizing material performance. +description: "Three.js 材质处理，用于 PBR、基础材质、Phong、ShaderMaterial、贴图绑定和材质性能优化。" --- # Three.js Materials diff --git a/plugins/codex/plugins/eapil-threejs-postprocessing/skills/threejs-postprocessing/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-postprocessing/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-postprocessing/skills/threejs-postprocessing/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-postprocessing/SKILL.md index 62675b9a5..bb0816495 100644 --- a/plugins/codex/plugins/eapil-threejs-postprocessing/skills/threejs-postprocessing/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-postprocessing/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-postprocessing -description: Three.js post-processing - EffectComposer, bloom, DOF, screen effects. Use when adding visual effects, color grading, blur, glow, or creating custom screen-space shaders. +description: "Three.js 后处理，用于 EffectComposer、bloom、景深、模糊、调色、屏幕空间效果和自定义 pass。" --- # Three.js Post-Processing diff --git a/plugins/codex/plugins/eapil-threejs-shaders/skills/threejs-shaders/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-shaders/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-shaders/skills/threejs-shaders/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-shaders/SKILL.md index f0dff82de..61cb51d5e 100644 --- a/plugins/codex/plugins/eapil-threejs-shaders/skills/threejs-shaders/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-shaders/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-shaders -description: Three.js shaders - GLSL, ShaderMaterial, uniforms, custom effects. Use when creating custom visual effects, modifying vertices, writing fragment shaders, or extending built-in materials. +description: "Three.js 着色器开发，用于 GLSL、ShaderMaterial、uniforms、自定义视觉效果、顶点修改和片元着色。" --- # Three.js Shaders diff --git a/plugins/codex/plugins/eapil-threejs-textures/skills/threejs-textures/SKILL.md b/plugins/codex/plugins/eapil-threejs/skills/threejs-textures/SKILL.md similarity index 98% rename from plugins/codex/plugins/eapil-threejs-textures/skills/threejs-textures/SKILL.md rename to plugins/codex/plugins/eapil-threejs/skills/threejs-textures/SKILL.md index 53642053e..4a89d3605 100644 --- a/plugins/codex/plugins/eapil-threejs-textures/skills/threejs-textures/SKILL.md +++ b/plugins/codex/plugins/eapil-threejs/skills/threejs-textures/SKILL.md @@ -1,6 +1,6 @@ --- name: threejs-textures -description: Three.js textures - texture types, UV mapping, environment maps, texture settings. Use when working with images, UV coordinates, cubemaps, HDR environments, or texture optimization. +description: "Three.js 纹理处理，用于图片纹理、UV、环境贴图、cubemap、HDR 环境和纹理加载优化。" --- # Three.js Textures diff --git a/plugins/codex/plugins/eapil-xlsx/.codex-plugin/plugin.json b/plugins/codex/plugins/eapil-xlsx/.codex-plugin/plugin.json index 7a4ee41fb..d1339ad1b 100644 --- a/plugins/codex/plugins/eapil-xlsx/.codex-plugin/plugin.json +++ b/plugins/codex/plugins/eapil-xlsx/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "eapil-xlsx", "version": "0.1.0", - "description": "EAPIL XLSX provides Codex guidance and helper scripts for spreadsheet creation, financial modeling conventions, formula validation, CSV handling, and workbook recalculation.", + "description": "EAPIL XLSX 提供电子表格创建、编辑、数据分析、公式校验、CSV 处理和工作簿重算相关的 Codex 工作流。", "author": { "name": "EAPIL", "url": "https://git.playones.com/arechen/EapilSkillMarket" @@ -17,18 +17,18 @@ "skills": "./skills/", "interface": { "displayName": "EAPIL XLSX", - "shortDescription": "Spreadsheet creation, editing, analysis, and recalculation workflows.", - "longDescription": "EAPIL XLSX provides Codex guidance and helper scripts for spreadsheet creation, financial modeling conventions, formula validation, CSV handling, and workbook recalculation.", + "shortDescription": "电子表格创建、编辑、分析、公式校验和重算工作流。", + "longDescription": "EAPIL XLSX 提供面向 Excel/CSV/TSV 工作簿的 Codex 工作流，覆盖电子表格创建、编辑、数据分析、格式处理、公式校验、财务建模约定和中文数据集场景。", "developerName": "EAPIL", - "category": "Data & Analytics", + "category": "数据分析", "capabilities": [ "Read", "Write" ], "defaultPrompt": [ - "Use EAPIL XLSX for this workbook.", - "Check formulas in this spreadsheet.", - "Create an Excel model." + "使用 EAPIL XLSX 处理这个工作簿。", + "检查这个电子表格里的公式。", + "创建一个 Excel 数据模型。" ], "websiteURL": "https://git.playones.com/arechen/EapilSkillMarket", "privacyPolicyURL": "https://git.playones.com/arechen/EapilSkillMarket", diff --git a/plugins/codex/plugins/eapil-xlsx/skills/xlsx/SKILL.md b/plugins/codex/plugins/eapil-xlsx/skills/xlsx/SKILL.md index fe808fdda..26a4a6b20 100644 --- a/plugins/codex/plugins/eapil-xlsx/skills/xlsx/SKILL.md +++ b/plugins/codex/plugins/eapil-xlsx/skills/xlsx/SKILL.md @@ -1,6 +1,6 @@ --- name: xlsx -description: "Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. Use when Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc.), especially on Windows and for Chinese/non-English datasets." +description: "电子表格创建、编辑和分析工具，支持公式、格式、数据分析、可视化、CSV/TSV 处理，以及中文/非英文数据集。" license: Proprietary. LICENSE.txt has complete terms --- @@ -387,4 +387,4 @@ with open('report.html', 'w', encoding='utf-8') as f: **For Excel files themselves**: - Add comments to cells with complex formulas or important assumptions - Document data sources for hardcoded values -- Include notes for key calculations and model sections \ No newline at end of file +- Include notes for key calculations and model sections diff --git a/plugins/codex/plugins/superpowers/.codex-plugin/plugin.json b/plugins/codex/plugins/superpowers/.codex-plugin/plugin.json index da22bc7ed..db595ea8b 100644 --- a/plugins/codex/plugins/superpowers/.codex-plugin/plugin.json +++ b/plugins/codex/plugins/superpowers/.codex-plugin/plugin.json @@ -1,47 +1,49 @@ { - "name": "superpowers", - "version": "5.1.0", - "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.", - "author": { - "name": "Jesse Vincent", - "email": "jesse@fsck.com", - "url": "https://github.com/obra" - }, - "homepage": "https://github.com/obra/superpowers", - "repository": "https://github.com/obra/superpowers", - "license": "MIT", - "keywords": [ - "brainstorming", - "subagent-driven-development", - "skills", - "planning", - "tdd", - "debugging", - "code-review", - "workflow" - ], - "skills": "./skills/", - "interface": { - "displayName": "Superpowers", - "shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents", - "longDescription": "Use Superpowers to guide agent work through brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.", - "developerName": "Jesse Vincent", - "category": "Coding", - "capabilities": [ - "Interactive", - "Read", - "Write" - ], - "defaultPrompt": [ - "I've got an idea for something I'd like to build.", - "Let's add a feature to this project." - ], - "websiteURL": "https://github.com/obra/superpowers", - "privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement", - "termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service", - "brandColor": "#F59E0B", - "composerIcon": "./assets/superpowers-small.svg", - "logo": "./assets/app-icon.png", - "screenshots": [] - } + "name": "superpowers", + "version": "5.1.0", + "description": "面向编码 Agent 的规划、TDD、调试、代码评审和交付工作流集合。", + "author": { + "name": "Jesse Vincent", + "email": "jesse@fsck.com", + "url": "https://github.com/obra" + }, + "homepage": "https://github.com/obra/superpowers", + "repository": "https://github.com/obra/superpowers", + "license": "MIT", + "keywords": [ + "brainstorming", + "subagent-driven-development", + "skills", + "planning", + "tdd", + "debugging", + "code-review", + "workflow" + ], + "skills": "./skills/", + "interface": { + "displayName": "Superpowers", + "shortDescription": "规划、TDD、调试、代码评审和交付工作流。", + "longDescription": "Superpowers 提供面向编码 Agent 的结构化工作流，覆盖需求澄清、计划编写、测试驱动开发、系统化调试、并行执行、代码评审和交付收尾。", + "developerName": "Jesse Vincent", + "category": "开发工具", + "capabilities": [ + "Interactive", + "Read", + "Write" + ], + "defaultPrompt": [ + "使用 Superpowers 帮我规划这个开发任务。", + "使用 Superpowers 帮我系统调试这个问题。" + ], + "websiteURL": "https://github.com/obra/superpowers", + "privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement", + "termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service", + "brandColor": "#F59E0B", + "composerIcon": "./assets/superpowers-small.svg", + "logo": "./assets/app-icon.png", + "screenshots": [ + + ] + } } diff --git a/plugins/codex/plugins/superpowers/skills/brainstorming/SKILL.md b/plugins/codex/plugins/superpowers/skills/brainstorming/SKILL.md index 06cd0a21e..115525658 100644 --- a/plugins/codex/plugins/superpowers/skills/brainstorming/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/brainstorming/SKILL.md @@ -1,6 +1,6 @@ --- name: brainstorming -description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation." +description: "在开始创造性工作前澄清意图、约束和可行方向；适合功能设计、组件设计和行为变更。" --- # Brainstorming Ideas Into Designs diff --git a/plugins/codex/plugins/superpowers/skills/dispatching-parallel-agents/SKILL.md b/plugins/codex/plugins/superpowers/skills/dispatching-parallel-agents/SKILL.md index a6a3f5a07..43c6b9102 100644 --- a/plugins/codex/plugins/superpowers/skills/dispatching-parallel-agents/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/dispatching-parallel-agents/SKILL.md @@ -1,6 +1,6 @@ --- name: dispatching-parallel-agents -description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies +description: "将两个或更多互不依赖的子任务分派给并行 Agent，以提升吞吐并保持边界清晰。" --- # Dispatching Parallel Agents diff --git a/plugins/codex/plugins/superpowers/skills/executing-plans/SKILL.md b/plugins/codex/plugins/superpowers/skills/executing-plans/SKILL.md index a59186273..b63bf4e5f 100644 --- a/plugins/codex/plugins/superpowers/skills/executing-plans/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/executing-plans/SKILL.md @@ -1,6 +1,6 @@ --- name: executing-plans -description: Use when you have a written implementation plan to execute in a separate session with review checkpoints +description: "按已经写好的实现计划逐步执行，并在关键节点进行检查和复核。" --- # Executing Plans diff --git a/plugins/codex/plugins/superpowers/skills/finishing-a-development-branch/SKILL.md b/plugins/codex/plugins/superpowers/skills/finishing-a-development-branch/SKILL.md index 43da0ae16..b5d9001ea 100644 --- a/plugins/codex/plugins/superpowers/skills/finishing-a-development-branch/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/finishing-a-development-branch/SKILL.md @@ -1,6 +1,6 @@ --- name: finishing-a-development-branch -description: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup +description: "实现完成且验证通过后，用于判断如何整理、提交和集成开发分支。" --- # Finishing a Development Branch diff --git a/plugins/codex/plugins/superpowers/skills/receiving-code-review/SKILL.md b/plugins/codex/plugins/superpowers/skills/receiving-code-review/SKILL.md index 4ea72cdf0..e9a75d714 100644 --- a/plugins/codex/plugins/superpowers/skills/receiving-code-review/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/receiving-code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: receiving-code-review -description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation +description: "处理代码评审反馈时使用，先理解反馈和技术依据，再决定是否修改。" --- # Code Review Reception diff --git a/plugins/codex/plugins/superpowers/skills/requesting-code-review/SKILL.md b/plugins/codex/plugins/superpowers/skills/requesting-code-review/SKILL.md index 34b834048..49c5fa8a5 100644 --- a/plugins/codex/plugins/superpowers/skills/requesting-code-review/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/requesting-code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: requesting-code-review -description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements +description: "完成较大改动后请求代码评审，重点检查需求满足、风险、测试和回归。" --- # Requesting Code Review diff --git a/plugins/codex/plugins/superpowers/skills/subagent-driven-development/SKILL.md b/plugins/codex/plugins/superpowers/skills/subagent-driven-development/SKILL.md index ea7ac8fd8..56c3a13e3 100644 --- a/plugins/codex/plugins/superpowers/skills/subagent-driven-development/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/subagent-driven-development/SKILL.md @@ -1,6 +1,6 @@ --- name: subagent-driven-development -description: Use when executing implementation plans with independent tasks in the current session +description: "按计划把独立实现任务交给子 Agent，并由主 Agent 负责整合和验证。" --- # Subagent-Driven Development diff --git a/plugins/codex/plugins/superpowers/skills/systematic-debugging/SKILL.md b/plugins/codex/plugins/superpowers/skills/systematic-debugging/SKILL.md index 111d2a98c..a9488a003 100644 --- a/plugins/codex/plugins/superpowers/skills/systematic-debugging/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/systematic-debugging/SKILL.md @@ -1,6 +1,6 @@ --- name: systematic-debugging -description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes +description: "遇到 bug、测试失败或异常行为时使用，通过复现、定位根因和验证修复来调试。" --- # Systematic Debugging diff --git a/plugins/codex/plugins/superpowers/skills/test-driven-development/SKILL.md b/plugins/codex/plugins/superpowers/skills/test-driven-development/SKILL.md index 7a751fa94..c17baa5aa 100644 --- a/plugins/codex/plugins/superpowers/skills/test-driven-development/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/test-driven-development/SKILL.md @@ -1,6 +1,6 @@ --- name: test-driven-development -description: Use when implementing any feature or bugfix, before writing implementation code +description: "实现功能或修复缺陷前使用，先写失败测试，再实现最小改动并重构。" --- # Test-Driven Development (TDD) diff --git a/plugins/codex/plugins/superpowers/skills/using-git-worktrees/SKILL.md b/plugins/codex/plugins/superpowers/skills/using-git-worktrees/SKILL.md index 134d37140..ea2b32579 100644 --- a/plugins/codex/plugins/superpowers/skills/using-git-worktrees/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/using-git-worktrees/SKILL.md @@ -1,6 +1,6 @@ --- name: using-git-worktrees -description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback +description: "开始需要隔离的功能开发时使用，通过 git worktree 建立独立工作区。" --- # Using Git Worktrees diff --git a/plugins/codex/plugins/superpowers/skills/using-superpowers/SKILL.md b/plugins/codex/plugins/superpowers/skills/using-superpowers/SKILL.md index c8a857024..ae83d5842 100644 --- a/plugins/codex/plugins/superpowers/skills/using-superpowers/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/using-superpowers/SKILL.md @@ -1,6 +1,6 @@ --- name: using-superpowers -description: Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions +description: "开始对话时了解如何发现和调用 Superpowers 技能。" --- diff --git a/plugins/codex/plugins/superpowers/skills/verification-before-completion/SKILL.md b/plugins/codex/plugins/superpowers/skills/verification-before-completion/SKILL.md index 2f14076e5..0897ef947 100644 --- a/plugins/codex/plugins/superpowers/skills/verification-before-completion/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/verification-before-completion/SKILL.md @@ -1,6 +1,6 @@ --- name: verification-before-completion -description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always +description: "在声称任务完成、修复成功或测试通过前使用，确保有实际验证证据。" --- # Verification Before Completion diff --git a/plugins/codex/plugins/superpowers/skills/writing-plans/SKILL.md b/plugins/codex/plugins/superpowers/skills/writing-plans/SKILL.md index 847412ece..7af893e13 100644 --- a/plugins/codex/plugins/superpowers/skills/writing-plans/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/writing-plans/SKILL.md @@ -1,6 +1,6 @@ --- name: writing-plans -description: Use when you have a spec or requirements for a multi-step task, before touching code +description: "在动手实现前编写多步骤计划，明确目标、约束、文件范围和验证方式。" --- # Writing Plans diff --git a/plugins/codex/plugins/superpowers/skills/writing-skills/SKILL.md b/plugins/codex/plugins/superpowers/skills/writing-skills/SKILL.md index c3b73d8b1..8a2e9624b 100644 --- a/plugins/codex/plugins/superpowers/skills/writing-skills/SKILL.md +++ b/plugins/codex/plugins/superpowers/skills/writing-skills/SKILL.md @@ -1,6 +1,6 @@ --- name: writing-skills -description: Use when creating new skills, editing existing skills, or verifying skills work before deployment +description: "创建、修改或验证 Agent skill 时使用，确保 skill 可触发、可维护、可测试。" --- # Writing Skills diff --git a/plugins/codex/plugins/ui-ux-pro-max/.codex-plugin/plugin.json b/plugins/codex/plugins/ui-ux-pro-max/.codex-plugin/plugin.json index 3b20fcf48..ec07c31ee 100644 --- a/plugins/codex/plugins/ui-ux-pro-max/.codex-plugin/plugin.json +++ b/plugins/codex/plugins/ui-ux-pro-max/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ui-ux-pro-max", "version": "2.5.0", - "description": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.", + "description": "面向界面设计、视觉风格、配色、字体、可访问性和前端技术栈的 UI/UX 设计智能库。", "author": { "name": "NextLevelBuilder" }, @@ -21,16 +21,17 @@ "skills": "./skills/", "interface": { "displayName": "UI/UX Pro Max", - "shortDescription": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.", - "longDescription": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.", + "shortDescription": "UI/UX 设计智能库，覆盖风格、配色、字体、可访问性、图表和前端技术栈。", + "longDescription": "UI/UX Pro Max 提供可搜索的设计知识库，覆盖 UI 风格、配色、字体搭配、UX 指南、图表类型和多种前端技术栈，用于辅助中文用户完成产品界面设计和前端实现决策。", "developerName": "NextLevelBuilder", - "category": "Design", + "category": "设计", "capabilities": [ "Read", "Write" ], "defaultPrompt": [ - "Use UI/UX Pro Max for this task." + "使用 UI/UX Pro Max 帮我设计这个界面。", + "使用 UI/UX Pro Max 帮我优化这个产品体验。" ], "websiteURL": "https://uupm.cc", "privacyPolicyURL": "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill", diff --git a/plugins/codex/plugins/ui-ux-pro-max/skills/ui-ux-pro-max/SKILL.md b/plugins/codex/plugins/ui-ux-pro-max/skills/ui-ux-pro-max/SKILL.md index a64d6c233..b882cc8aa 100644 --- a/plugins/codex/plugins/ui-ux-pro-max/skills/ui-ux-pro-max/SKILL.md +++ b/plugins/codex/plugins/ui-ux-pro-max/skills/ui-ux-pro-max/SKILL.md @@ -1,6 +1,6 @@ --- name: ui-ux-pro-max -description: "UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient. Integrations: shadcn/ui MCP for component search and examples." +description: "用于界面设计、视觉风格、配色、字体、可访问性、图表和前端技术栈选择的 UI/UX 设计智能库。" --- # UI/UX Pro Max - Design Intelligence @@ -656,4 +656,4 @@ Scope notice: This checklist is for App UI (iOS/Android/React Native/Flutter). - [ ] Form fields have labels, hints, and clear error messages - [ ] Color is not the only indicator - [ ] Reduced motion and dynamic text size are supported without layout breakage -- [ ] Accessibility traits/roles/states (selected, disabled, expanded) are announced correctly \ No newline at end of file +- [ ] Accessibility traits/roles/states (selected, disabled, expanded) are announced correctly diff --git a/scripts/sync_external_plugins.ps1 b/scripts/sync_external_plugins.ps1 index af7e5835f..a7c5c1a39 100644 --- a/scripts/sync_external_plugins.ps1 +++ b/scripts/sync_external_plugins.ps1 @@ -69,7 +69,8 @@ function Copy-PathIfExists { function Read-JsonFile { param([string]$Path) - return Get-Content -Raw -LiteralPath $Path | ConvertFrom-Json + $resolvedPath = (Resolve-Path -LiteralPath $Path).Path + return [System.IO.File]::ReadAllText($resolvedPath, [System.Text.Encoding]::UTF8) | ConvertFrom-Json } function Write-JsonFile { @@ -79,17 +80,30 @@ function Write-JsonFile { [System.IO.File]::WriteAllText($Path, "$json`n", $utf8NoBom) } +function Write-Utf8NoBomText { + param([string]$Path, [string]$Text) + $utf8NoBom = New-Object System.Text.UTF8Encoding($false) + [System.IO.File]::WriteAllText($Path, $Text, $utf8NoBom) +} + function ConvertTo-Hashtable { param([object]$InputObject) if ($null -eq $InputObject) { return $null } + if ($InputObject -is [System.Collections.IDictionary]) { + $hash = [ordered]@{} + foreach ($key in $InputObject.Keys) { + $hash[$key] = ConvertTo-Hashtable $InputObject[$key] + } + return $hash + } if ($InputObject -is [System.Collections.IEnumerable] -and -not ($InputObject -is [string]) -and -not ($InputObject -is [System.Management.Automation.PSCustomObject])) { $items = @() foreach ($item in $InputObject) { $items += ConvertTo-Hashtable $item } - return $items + return ,$items } if ($InputObject -is [System.Management.Automation.PSCustomObject]) { $hash = [ordered]@{} @@ -103,7 +117,7 @@ function ConvertTo-Hashtable { function Get-SkillFrontmatter { param([string]$SkillFile) - $lines = Get-Content -LiteralPath $SkillFile + $lines = [System.IO.File]::ReadAllLines((Resolve-Path -LiteralPath $SkillFile).Path, [System.Text.Encoding]::UTF8) if ($lines.Count -lt 3 -or $lines[0] -ne "---") { return @{} } @@ -121,6 +135,108 @@ function Get-SkillFrontmatter { return $frontmatter } +function Merge-Hashtable { + param( + [object]$Base, + [object]$Override + ) + $baseHash = ConvertTo-Hashtable $Base + $overrideHash = ConvertTo-Hashtable $Override + foreach ($key in $overrideHash.Keys) { + if ($baseHash.Contains($key) -and $baseHash[$key] -is [System.Collections.IDictionary] -and $overrideHash[$key] -is [System.Collections.IDictionary]) { + $baseHash[$key] = Merge-Hashtable -Base $baseHash[$key] -Override $overrideHash[$key] + } else { + $baseHash[$key] = $overrideHash[$key] + } + } + return $baseHash +} + +function Get-SourceCategory { + param([object]$Source) + if ($Source.PSObject.Properties.Name -contains "marketplace" -and $Source.marketplace -and $Source.marketplace.category) { + return $Source.marketplace.category + } + return $Source.category +} + +function ConvertTo-YamlDoubleQuoted { + param([string]$Value) + $escaped = $Value.Replace("\", "\\").Replace('"', '\"') + return "`"$escaped`"" +} + +function Set-SkillFrontmatterValue { + param( + [string]$SkillFile, + [string]$Key, + [string]$Value + ) + $lines = @([System.IO.File]::ReadAllLines((Resolve-Path -LiteralPath $SkillFile).Path, [System.Text.Encoding]::UTF8)) + if ($lines.Count -lt 3 -or $lines[0] -ne "---") { + throw "Cannot update frontmatter in $SkillFile" + } + + $endIndex = -1 + for ($i = 1; $i -lt $lines.Count; $i++) { + if ($lines[$i] -eq "---") { + $endIndex = $i + break + } + } + if ($endIndex -lt 0) { + throw "Cannot find frontmatter end in $SkillFile" + } + + $replacement = "$Key`: $(ConvertTo-YamlDoubleQuoted $Value)" + $updated = $false + for ($i = 1; $i -lt $endIndex; $i++) { + if ($lines[$i] -match "^\s*$([regex]::Escape($Key))\s*:") { + $lines[$i] = $replacement + $updated = $true + break + } + } + + if (-not $updated) { + $before = @() + if ($endIndex -gt 1) { + $before = $lines[0..($endIndex - 1)] + } else { + $before = @($lines[0]) + } + $after = $lines[$endIndex..($lines.Count - 1)] + $lines = @($before + $replacement + $after) + } + + Write-Utf8NoBomText -Path $SkillFile -Text (($lines -join "`n") + "`n") +} + +function Apply-LocalOverrides { + param( + [string]$PluginDir, + [object]$Source + ) + + if ($Source.PSObject.Properties.Name -contains "manifestOverrides" -and $Source.manifestOverrides) { + $manifestPath = Join-Path $PluginDir ".codex-plugin\plugin.json" + $manifest = ConvertTo-Hashtable (Read-JsonFile $manifestPath) + $manifest = Merge-Hashtable -Base $manifest -Override $Source.manifestOverrides + Write-JsonFile -Path $manifestPath -Value $manifest + } + + if ($Source.PSObject.Properties.Name -contains "skillDescriptions" -and $Source.skillDescriptions) { + $skillsRoot = Join-Path $PluginDir "skills" + foreach ($property in $Source.skillDescriptions.PSObject.Properties) { + $skillFile = Join-Path (Join-Path $skillsRoot $property.Name) "SKILL.md" + if (-not (Test-Path -LiteralPath $skillFile)) { + throw "skillDescriptions references missing skill: $skillFile" + } + Set-SkillFrontmatterValue -SkillFile $skillFile -Key "description" -Value $property.Value + } + } +} + function Get-Clone { param( [object]$Source, @@ -201,6 +317,7 @@ function Sync-CodexPlugin { $dst = Join-Path $pluginDir $include Copy-PathIfExists -Source $src -Destination $dst -Within $RepoRoot } + Apply-LocalOverrides -PluginDir $pluginDir -Source $Source Write-Provenance -PluginDir $pluginDir -Source $Source -Commit $Commit -SyncedAt $SyncedAt -SourcePath $relativeSourcePath } @@ -301,7 +418,7 @@ function Sync-ClaudeSkill { shortDescription = $description longDescription = $description developerName = (New-AuthorObject $metadata.author).name - category = $Source.category + category = (Get-SourceCategory $Source) capabilities = @("Read", "Write") defaultPrompt = @("Use $displayName for this task.") websiteURL = $homepage @@ -312,6 +429,7 @@ function Sync-ClaudeSkill { } } Write-JsonFile -Path (Join-Path $pluginDir ".codex-plugin\plugin.json") -Value $manifest + Apply-LocalOverrides -PluginDir $pluginDir -Source $Source Write-Provenance -PluginDir $pluginDir -Source $Source -Commit $Commit -SyncedAt $SyncedAt -SourcePath $Source.skillPath } @@ -340,7 +458,7 @@ function Update-Marketplace { installation = "AVAILABLE" authentication = "ON_INSTALL" } - category = $source.category + category = (Get-SourceCategory $source) } } $marketplace.plugins = $plugins