AgentSkillsCN

wp-project-triage

当需要对 WordPress 仓库（插件/主题/区块主题/WP 核心/Gutenberg/全站）进行确定性检查时使用，涵盖工具链、测试用例、版本提示，并生成结构化的 JSON 报告，以指导工作流程并设置必要的防护措施。

SKILL.md
--- frontmatter
name: wp-project-triage
description: "Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version hints, and a structured JSON report to guide workflows and guardrails."
compatibility: "Targets WordPress 6.9+ (PHP 7.2.24+). Filesystem-based agent with bash + node. Some workflows require WP-CLI."

WP Project Triage

When to use

Use this skill to quickly understand what kind of WordPress repo you’re in and what commands/conventions to follow before making changes.

Inputs required

  • •Repo root (current working directory).

Procedure

  1. •Run the detector (prints JSON to stdout):
    • •node skills/wp-project-triage/scripts/detect_wp_project.mjs
  2. •If you need the exact output contract, read:
    • •skills/wp-project-triage/references/triage.schema.json
  3. •Use the report to select workflow guardrails:
    • •project kind(s)
    • •PHP/Node tooling present
    • •tests present
    • •version hints and sources
  4. •If the report is missing signals you need, update the detector rather than guessing.

Verification

  • •The JSON should parse and include: project.kind, signals, and tooling.
  • •Re-run after changes that affect structure/tooling (adding theme.json, block.json, build config).

Failure modes / debugging

  • •If it reports unknown, check whether the repo root is correct.
  • •If scanning is slow, add/extend ignore directories in the script.