// 规范化梳理与排查 PowerXPlugin 仓库的 GitHub Actions CI/Release 覆盖范围，并指导如何按既定规范追加测试用例与发布前校验。适用于：CI 通过但 tag/release 失败、需要确认当前 workflow 覆盖了哪些模块/用例、要把新功能纳入 CI（含模板同步、px-plugin init 生成物、Go/Node 测试、Playwright 回归）等场景。
生成功能使用指导文档（人性化、可执行、与代码实现对齐）。强制包含背景、流程图、泳道图、模块关系、页面/接口步骤、前后置依赖、验证与排障。
自动检查 contracts/capabilities 与 plugin.yaml/catalog（plugin.d）的同步对齐，适用于功能迭代后快速发现路由、RBAC、清单漂移问题。
FastAPI 后端配置加载规范（与 Gin 对齐）
FastAPI 后端入口技能，按需路由到配置与数据库/同步规范子技能。
Gin 后端配置加载规范
Gin 后端入口技能，按需路由到配置规范子技能。
| name | ci-audit |
| description | 规范化梳理与排查 PowerXPlugin 仓库的 GitHub Actions CI/Release 覆盖范围，并指导如何按既定规范追加测试用例与发布前校验。适用于：CI 通过但 tag/release 失败、需要确认当前 workflow 覆盖了哪些模块/用例、要把新功能纳入 CI（含模板同步、px-plugin init 生成物、Go/Node 测试、Playwright 回归）等场景。 |
node .codex/skills/ci/audit/scripts/ci-inventory.mjsnode .codex/skills/ci/audit/scripts/ci-diff.mjsnode .codex/skills/ci/audit/scripts/ci-guardrails.mjs识别“触发条件”
.github/workflows/ci.yml（push/pr）与 .github/workflows/release.yml（tag v*）。盘点“覆盖范围”
ci-inventory.mjs，把输出粘进 issue/PR/comment（作为“当前规范基线”）。references/coverage-matrix.md 判断：后端/前端/模板/CLI/契约/回归是否都被覆盖。如果问题只在 tag/release 触发
ci-diff.mjs 找出 release 独有步骤（例如 working-directory、打包/归档、示例工程生成）。ci-guardrails.mjs 做“目录存在性/路径引用”预检；必要时把 guardrails 融进 CI（见 references/guardrails.md）。追加测试用例（遵循准入标准）
ci.yml 的相应 job 覆盖（framework / backend / tools/cli）。web-admin（或对应 workspace）并由 frontend job 覆盖。template-sync 或 cli job 的 smoke（px-plugin init + 关键文件存在性）。tests/（Playwright）并由 regression job 覆盖。references/powerx-ci-standards.mdreferences/coverage-matrix.mdreferences/guardrails.mdreferences/common-failures.md