Agent Workpress Skill

也可触发（中置信，需要确认是否就是要跑脚本/走 API）：

• 用户明确提到“运行 node 脚本/CLI”、“scripts/xxx.js”、“base-url/token/auth-code”等参数
• 用户要求“输出 JSON/调用接口/自动化流程”来批量处理 WordPress 内容

不触发（低置信）：

• 仅讨论 WordPress 前端/主题/插件 UI（不涉及调用本仓库脚本）
• 仅写文案/排版建议但不需要落地到站点（除非用户接着说要发布到站点）

目录与分层加载

• Level 1（元数据，始终加载）：本文件顶部的 YAML（name/description）
• Level 2（说明文档，触发时加载）：./SKILL.md 正文（策略、流程、约束、路由）
• Level 3（资源与代码，按需加载）：./FORMS.md、./examples/*.md、./scripts/*.js

架构原理（为什么这样分层）

• Skill 运行在受控沙盒环境中：模型可按需读取文件并执行命令，用“工具箱”的方式完成任务。
• 通过分层加载平衡效果与上下文成本：
  • 元数据很轻量 → 可以安装很多 Skill
  • 说明文档仅在意图匹配时加载 → 避免无关内容占用上下文
  • 资源与脚本按需读取/执行 → 可以打包大量资料但只在需要时消耗 Token

调用逻辑（从用户意图到执行结果）

1. 意图匹配：根据元数据（name/description）判断是否应启用本 Skill。
2. 读取手册：触发后加载 SKILL.md，按其中流程与约束执行。
3. 按需取用资源：需要参数细节时查 FORMS.md；需要范例时查 examples/；真正操作时执行 scripts/*.js。
4. 反馈结果：返回结构化摘要（必要时附原始 JSON），遇到缺参/不确定信息先提问。

前置条件

• Node.js 18+
• 必填：--base-url
• 认证二选一：--token 或 --auth-code
• 可选：--verbose

执行原则

1. 先识别意图，再选命令。
2. 参数不全先提问，不猜 URL/ID/凭据。
3. 只执行当前目标所需的最小命令。
4. 返回结构化结果（优先 id/title/status/link/updated_at）。
5. 删除类操作（delete、cleanup）必须先确认。

命令入口（在项目根目录执行）

• node scripts/auth.js exchange
• node scripts/users.js me
• node scripts/agent.js capabilities
• node scripts/posts.js <create|list|get|update|delete>
• node scripts/pages.js <create|list>
• node scripts/comments.js <list|create|update|delete|moderate>
• node scripts/media.js <upload|list>
• node scripts/taxonomies.js <categories-list|categories-create|tags-list>
• node scripts/skills.js <publish-post-with-image|update-or-create-category-then-post|moderate-comment-and-reply|create-draft-with-cleanup>

标准流程（Structured Instructions）

1. 识别任务类型：查询 / 创建 / 更新 / 删除 / 复合流程。
2. 校验参数：base-url、认证参数、业务参数。
3. 生成并执行命令。
4. 解析 JSON 并提炼关键字段。
5. 失败时输出错误信息与修复建议。

接口与输出规范（Interface Design）

• 输入：自然语言需求 + CLI 参数。
• 输出：优先 JSON 关键字段摘要，必要时附完整原始输出。
• 详情参数请查阅：./FORMS.md
• 示例请查阅：./examples/

约束（Do / Don’t）

• Do：严格按用户目标执行，必要时先补齐参数。
• Don’t：不泄露 token，不猜测私有 URL，不在未确认时执行删除操作。