Name: ystandard
Author: yosiakatsuki

Imported from yosiakatsuki/ystandard (AGENTS.md). Install upstream with npx skills add yosiakatsuki/ystandard. Copyright stays with the author.

yStandard

WordPress クラシックテーマ（GPL-2.0+）。無料配布のカスタマイズ志向テーマ。

テキストドメイン: ystandard
PHP 名前空間: ystandard（サブ名前空間: ystandard\helper）
フックプレフィックス: ys_
配布テーマとしての必須 PHP: 7.4+
開発環境の PHP: composer.json の要件に従う
必須 WP: 6.1+

開発コマンド

ビルド

npm run build          # CSS(Sass→PostCSS)・JS(Babel) の全ビルド
npm run watch          # 開発用ウォッチ（CSS・JS）
npm run zip            # 配布用 zip 作成

Lint

npm run lint           # PHP(PHPCS) を実行
composer phpcs         # PHPCS 直接実行（WordPress-Core + WordPress-Docs）

テスト

npm run test           # Playground CLI上でPHPUnit実行
npm run wpenv:test     # wp-env上でPHPUnit実行（Docker環境が必要）
composer test          # PHPUnit直接実行（ローカルWordPressテスト環境が必要）

テストファイルは tests/ 配下、test- プレフィックス付き PHP ファイル。

wp-env

npm run wpenv:start    # Xdebug 有効で起動
npm run wpenv:stop     # 停止

コーディング規約

PHPCS ルール: WordPress-Core + WordPress-Docs（.phpcs.xml.dist 参照）
短縮配列構文 [] を許可（DisallowShortArraySyntax を除外済み）
JS/CSS: @wordpress/eslint-plugin + @wordpress/prettier-config に準拠
CSS は Sass（src/sass/, src/block-styles/）で記述し、PostCSS で後処理

アーキテクチャ

inc/: PHP クラス群。機能ごとにサブディレクトリ（header/, seo/, blocks/ 等）
inc/class-ys-loader.php: テーマの起点。functions.php からこれだけ読み込む
inc/helper/: 汎用ヘルパー（ystandard\helper 名前空間）
src/sass/ → css/: テーマ CSS のビルド元
src/block-styles/ → css/block-styles/: ブロックスタイル CSS のビルド元
src/js/ → js/: Babel でトランスパイル
template-parts/: テンプレートパーツ群
library/: 外部ライブラリ（PHPCS・ビルド対象外）

ワークフロー

メインブランチ: master
開発ブランチ: develop-v4（push で CI 実行 → PHP 構文チェック → PHPCS → PHPUnit → 開発版デプロイ）
リリースブランチ: release-v4（push で本番デプロイ）
CI: PHP 7.2〜8.2 での構文チェック、PHP 8.1 での PHPCS・テスト

注意事項

IMPORTANT: ユーザー入力・出力には必ずサニタイズ・エスケープを行い、フォーム処理には nonce チェックを入れること
IMPORTANT: $wpdb 直接クエリを使う場合は必ず $wpdb->prepare() を通すこと。既存の WP 関数で代替できないか先に検討する
IMPORTANT: 翻訳関数（__(), esc_html__() 等）を使い、テキストドメイン ystandard を指定すること。ハードコードされた日本語文字列を直接出力しない

AI ツール向け補足

個人環境に依存する設定（.codex/, MCP 設定, Serena 設定など）はリポジトリに含めない。
シンボル構造の把握には、利用可能であれば Serena などのコード理解ツールを使う。
変更後は影響範囲に応じて npm run lint, npm run build, npm run test のいずれかを実行する。実行できない場合は理由を報告する。

Install ystandard and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "yosiakatsuki-ystandard-ystandard", "kind": "skill", "name": "ystandard", "description": "WordPress クラシックテーマ（GPL-2.0+）。無料配布のカスタマイズ志向テーマ。", "publisher": "yosiakatsuki", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "WordPress クラシックテーマ（GPL-2.0+）。無料配布のカスタマイズ志向テーマ。" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/yosiakatsuki/ystandard", "path": "AGENTS.md", "ref": "2042518800cceb111d5fe93ec4a2014a6aa5a021", "url": "https://github.com/yosiakatsuki/ystandard/blob/2042518800cceb111d5fe93ec4a2014a6aa5a021/AGENTS.md", "key": "yosiakatsuki/ystandard/AGENTS.md" } }, "instructions": "# yStandard\n\nWordPress クラシックテーマ（GPL-2.0+）。無料配布のカスタマイズ志向テーマ。\n\n- テキストドメイン: `ystandard`\n- PHP 名前空間: `ystandard`（サブ名前空間: `ystandard\\helper`）\n- フックプレフィックス: `ys_`\n- 配布テーマとしての必須 PHP: 7.4+\n- 開発環境の PHP: composer.json の要件に従う\n- 必須 WP: 6.1+\n\n## 開発コマンド\n\n### ビルド\n\n```bash\nnpm run build # CSS(Sass→PostCSS)・JS(Babel) の全ビルド\nnpm run watch # 開発用ウォッチ（CSS・JS）\nnpm run zip # 配布用 zip 作成\n```\n\n### Lint\n\n```bash\nnpm run lint # PHP(PHPCS) を実行\ncomposer phpcs # PHPCS 直接実行（WordPress-Core + WordPress-Docs）\n```\n\n### テスト\n\n```bash\nnpm run test # Playground CLI上でPHPUnit実行\nn", "cost": { "context_tokens": 548 } }

ystandard

About