메뉴
Updates Nacos Maintainer SDK documentation by comparing Maintainer Client interfaces with maintainer-sdk.md, then adding/removing APIs and overloads while preserving existing descriptions and examples.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Discover, install, update, merge, publish, and synchronize AI skills with Nacos for personal or team skill registries. Route detailed skill-sync workflows to https://nacos.io/skill-sync/SKILL.md.
Use when the user needs to synchronize local AI agent skills across Codex, Claude, Qoder, QoderWork, Cursor, Kiro, Lingma, CoPaw, OpenClaw, ~/.agents/skills, ~/.skills, and optionally a Nacos Skill Registry. Handles skill-sync setup, add/start/status/resolve/stop flows, Nacos mode and local mode, non-interactive agent execution, conflict triage, auto-upload state, Upload blocked handling, and safe human decision points.
Updates Nacos API documentation from Swagger api.json. **Must try to refresh api.json via curl first**; only if that fails, use existing api.json. **Compare** generated md with existing docs and **update in place** (add/remove params, fix URL/curl); **do not** use any sync script that overwrites sections (preserve existing descriptions and examples). Use when updating API docs from Swagger or generating console/admin/client API markdown.
Updates Nacos committer documentation and announcements in nacos-group.github.io. Use when adding one or more new Nacos Committers, creating a committer community announcement, syncing committer/developer rows across all versioned zh-cn and en nacos-dev.md files, handling missing company information such as defaulting to independent developer, or validating historical developer-list consistency.
Updates Nacos download page and release history from a GitHub release URL. Fetches version and MD5 from the release, updates nacos-server.mdx (stable/snapshot), migrates previous stable row to release-history.mdx, updates the top tip with release summary, and syncs all changes to other locales (e.g. en). Use when the user provides a GitHub release link to update the download page or when asked to update Nacos download/release history from a release.
Updates Nacos Java SDK usage documentation by comparing Java Client interfaces with usage.md, then adding/removing APIs and overloads while preserving existing descriptions and examples.
| name | nacos-java-maintainer-sdk |
| description | Updates Nacos Maintainer SDK documentation by comparing Maintainer Client interfaces with maintainer-sdk.md, then adding/removing APIs and overloads while preserving existing descriptions and examples. |
编写或更新 运维 SDK 使用手册（manual/admin/maintainer-sdk.md）时，请严格遵循本 skill 下的格式说明；通过解析 Nacos Maintainer Client 的接口定义（含多层继承）与 maintainer-sdk.md 对比，补全新增 API、标出新增重载、并标出接口中已删除的重载（文档需同步移除或标注）。
仅修改 next 版本文档：本 skill 涉及的所有编辑、对比、补全，只针对 src/content/docs/next/ 下的 maintainer-sdk.md（中英文）。不得修改 latest、v3.0 或其他版本目录下的文档；其他版本由发布流程或人工同步。
本 skill 的对比与解析依赖 Nacos 仓库中的 Maintainer Client 接口源码。不同使用者的本机路径不同，因此不会在 skill 或脚本中写死 nacos 路径。
~/Documents/nacos、../nacos、/path/to/nacos 等）。--nacos-maintainer-dir 传入 nacos 中的 maintainer-client 源码目录（见下方「使用方式」）。可传绝对路径或相对于当前工作目录的相对路径。若本地暂无 nacos 仓库，可先 git clone https://github.com/alibaba/nacos.git 再执行脚本。
以下接口为文档的 API 来源；存在多层继承关系，解析时需展开父接口方法并按「章节归属」归类（见 reference.md）。文档大章与接口对应关系如下：
| 接口 (interface) | 文档章节 | 说明 |
|---|---|---|
ConfigMaintainerService 及其配置相关父接口（BetaConfigMaintainerService、ConfigHistoryMaintainerService、ConfigOpsMaintainerService，不含 CoreMaintainerService） | 第 3 章 配置中心运维 API | 配置中心 |
NamingMaintainerService 及其服务发现相关父接口（ServiceMaintainerService、InstanceMaintainerService、NamingClientMaintainerService，不含 CoreMaintainerService） | 第 4 章 服务发现运维API | 注册中心 |
CoreMaintainerService | 第 5 章 其他Nacos核心运维API | Nacos 核心通用 |
McpMaintainerService（由 AiMaintainerService 继承） | 第 6 章 MCP 服务 | Ai 相关 - MCP |
A2aMaintainerService（由 AiMaintainerService 继承） | 第 7 章 A2A 注册中心 | Ai 相关 - A2A |
PromptMaintainerService（由 AiMaintainerService.prompt() 代理） | 第 8 章（若文档已增加） | Ai 相关 - Prompt |
SkillMaintainerService（由 AiMaintainerService.skill() 代理） | 第 9 章（若文档已增加） | Ai 相关 - Skill |
AgentSpecMaintainerService（由 AiMaintainerService.agentSpec() 代理） | 第 10 章（若文档已增加） | Ai 相关 - AgentSpec |
接口在 nacos 仓库中的路径：maintainer-client/src/main/java/com/alibaba/nacos/maintainer/client/ 下对应包名（config/、naming/、core/、ai/）。因此 --nacos-maintainer-dir 应指向 nacos 仓库根目录下的 maintainer-client/src/main/java（或任一包含 com/alibaba/nacos/maintainer/client 的父目录）。
以下方法虽在接口中存在，但不视为对外能力 API，不要在 maintainer-sdk.md 中单独成节或补全；对比脚本会从「NEW APIs」中排除，不会建议补全。
| 方法名 | 所属接口 | 说明 |
|---|---|---|
fillAllPattern | ConfigMaintainerService | 仅为其他 API 提供的公有工具方法（将字符串补全为首尾 * 的模糊匹配模式），非实际运维能力，不写入 API 文档。 |
后续若有同类约定，在本表与对比脚本的 SKIP_NEW_API 中同步更新。
在文档仓库根目录（nacos-group.github.io）执行，并将下面的 nacos 路径替换为你本机的 nacos 仓库路径：
# 将 YOUR_NACOS_REPO 替换为本机 nacos 仓库路径
python .agents/skills/nacos-java-maintainer-sdk/scripts/compare_maintainer_api_with_doc.py \
--nacos-maintainer-dir YOUR_NACOS_REPO/maintainer-client/src/main/java \
--maintainer-md src/content/docs/next/zh-cn/manual/admin/maintainer-sdk.md
--nacos-maintainer-dir：必填。本机 nacos 仓库中的 maintainer-client/src/main/java 的路径（绝对路径或相对当前目录均可）。--maintainer-md：当前要对比的 maintainer-sdk.md，必须为 next 版本路径；不要传入 latest、v3.0 等路径。输出：
可选：加 --json 输出机器可读的 JSON，便于脚本或 AI 使用。
不明确则暂不修改：修改过程中若某处无法从接口或现有文档明确判断，不要猜测修改；应将该条列入报告中的「待确认内容」，待后续确认后再修改。
每次对 next 版 maintainer-sdk.md 进行增删改后，必须生成一份修改报告，便于审阅与追溯。报告不写入文档；报告可仅在对话中输出，或由执行者自行保存到其他位置。
报告应包含：新增的 API 文档、移除的 API 文档、修改的 API 文档（含修改类型：描述 / API 定义 / 新增重载 / 删除重载 / 示例变更 / 异常说明）、待确认内容。无变更时可在报告中说明「本次无变更」；有待确认项时必须在报告中列出。
仅列出接口中的方法签名（含继承展开），不对比文档。同样需要传入你本机的 nacos 路径：
python .agents/skills/nacos-java-maintainer-sdk/scripts/parse_maintainer_interface.py \
--dir YOUR_NACOS_REPO/maintainer-client/src/main/java
单文件解析：--file path/to/ConfigMaintainerService.java。按章节输出：--by-chapter。输出 JSON：--json。
| 脚本 | 作用 |
|---|---|
| scripts/parse_maintainer_interface.py | 解析 Maintainer Java 接口源码，支持多层继承：解析 extends 并递归加载父接口，按章节归属汇总方法；提取方法名、参数个数、返回类型、@since、声明接口等。 |
| scripts/compare_maintainer_api_with_doc.py | 解析各章节对应接口（含继承），解析 maintainer-sdk.md 中已文档化的方法，输出新增 API、新增重载与已删除重载列表；不修改任何文件。 |
latest、v3.0 等非 next 版本文档；本 skill 只编辑 src/content/docs/next/{zh-cn|en}/manual/admin/maintainer-sdk.md。