AgentSkillsCN

api-conventions

在代码变更后,运行 Xcode 构建以检查编译错误和警告。通过使用 -skipMacroValidation 标志,跳过 ComposableArchitecture 宏的验证。当您需要进行构建确认、编译、排查构建错误,或在变更后进行验证时,可选用此方法。

SKILL.md
--- frontmatter
name: api-conventions
description: REST API conventions for WordPress MCP SaaS
user-invocable: false

API Conventions

Authentication Headers

JWT (Dashboard)

code
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

API Key (MCP Clients)

code
Authorization: Bearer n2f_xxxxxxxxxxxxx

WordPress Credentials (Multi-tenant)

code
x-wordpress-url: https://wp.example.com
x-wordpress-username: admin
x-wordpress-password: ApplicationPasswordNoSpaces

Response Format

Success

json
{
  "success": true,
  "data": { ... }
}

Error

json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Title is required"
  }
}

HTTP Status Codes

StatusMeaning
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Internal Error

WordPress-Specific Errors

CodeDescription
WP_AUTH_FAILEDWordPress authentication failed
WP_NOT_FOUNDWordPress resource not found
WP_API_ERRORWordPress API returned error
APP_PASSWORD_FORMATApplication Password has spaces