一键在 Manus 中运行任何 Skill

basercms4-development

星标193

分支141

更新时间2026年7月3日 04:54

baserCMS 4系（CakePHP 2.10ベース）＋ jQuery プロジェクトの開発ルール集。「baserCMS 4 で開発」「4系のプラグインを修正」「CakePHP 2系のコードを書く」「app/Plugin 配下の Controller／Model／View」「テーマの Elements／Layouts」「BcBaserHelper／BcFormHelper／BcHtmlHelper の利用」「CakeLog でログ出力」「lib/Baser・lib/Cake はコアハック禁止」等、baserCMS 4系プロジェクトのコーディング方針・ディレクトリ構成・命名規則・ログ／エラーハンドリング・読み取り専用ファイルの扱い・サーバ制約を確認する際に参照する。baserCMS 5系の開発は basercms5-development、4→5 へのアップグレードは basercms4-to-5-upgrade スキルを参照。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

baserproject

baserproject/basercms

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

baserCMS4系（CakePHP2系）＋ jQuery プロジェクトの開発ルール

このプロジェクトでは、以下の技術スタックおよび設計方針に従って開発されています。

使用技術

baserCMS 4系 を使用（内部的には CakePHP 2.10 ベース）
バックエンド：PHP 7.4 〜 8.2 / CakePHP 2系
データベース：MySQL 5.7 〜 8.0
フロントエンド：jQuery 1.x〜3.x（プロジェクト内で複数バージョンが混在している可能性あり）
HTTPサーバ：Apache（mod_rewrite 有効）

ディレクトリ構成のルール

MVC構成は CakePHP 2系に準拠しつつ、baserCMSでは主にプラグイン単位で構築されている
- app/Plugin/{Plugin名}/Controller/, Model/, View/ にそれぞれ配置される
共通パーツ（ヘッダー、フッターなど）は、テーマ内の Elements/ ディレクトリに配置
- 主に：theme/{テーマ名}/Elements/
- 一部環境では：app/webroot/theme/{テーマ名}/Elements/
レイアウトもテーマ内に配置される
- 主に：theme/{テーマ名}/Layouts/
- 一部環境では：app/webroot/theme/{テーマ名}/Layouts/
- $this->layout により切り替えが可能
管理画面系は /admin/ プレフィックスのURLルーティングで制御
- 使用ファイル：app/Config/core.php
- 定義内容：Configure::write('Routing.prefixes', array('admin'));

コーディング方針（baserCMS4固有）

共通ルールのコーディング方針も参照してください。

クラスベースよりも関数ベース・手続き的なコードが多く採用されている
JavaScript は Viewファイル内の <script> タグ内または .js ファイルに記述
Ajax通信は jQuery（$.ajax()）を用いて行う
ES6構文（Promise, fetch, import/export）は使用しない
フロント実装に React や Vue などの SPA 技術は導入していない
- 一部、部分的に利用している箇所がある

命名規則（baserCMS4固有）

共通ルールの命名規則も参照してください。

※ baserCMSやCakePHPの命名慣習（Controller, Helper, Modelなど）はそのまま準拠する

ログ・エラーハンドリング方針（baserCMS4固有）

共通ルールのログ・エラーハンドリング方針も参照してください。

目的： /log エイリアスや、例外処理実装時の提案精度向上

baserCMS4固有の実装方法

PHPでは CakeLog::error() または error_log() を利用
JavaScriptでは console.error() を暫定対応とし、本実装時はサーバ送信も検討

実装例（baserCMS用で設定ファイルに記述）：

/**
 * 専用ログ
 */
if (!defined('PROJECT_PLUGIN_ACTION')) {
	define('PROJECT_PLUGIN_ACTION', 'project_plugin_action');
	CakeLog::config('project_plugin_action', [
		'engine' => 'FileLog',
		'types' => ['project_plugin_action'],
		'file' => 'project_plugin_action',
		'size' => '5MB',
		'rotate' => 5,
	]);
}

// ログを取りたい箇所に記述する
$this->log('Start', PROJECT_PLUGIN_ACTION);
$this->log(print_r($array, true), PROJECT_PLUGIN_ACTION);

使用ライブラリとヘルパー

BcBaserHelper, BcFormHelper, BcHtmlHelper など baserCMS 固有ヘルパーを活用
HTML の出力は $this->BcBaser->css(), $this->BcBaser->img() などを使用し、手書きは控えめにする

ファイル・ディレクトリに関する扱いルール

目的： AIがコードを解析・提案する際に、以下の3つの分類に基づいて適切に扱うことで、不要な提案や誤った変更を防ぎます。

読み取り専用：フレームワークのコアファイルなど、参照はするが変更は禁止
設定調査用：設定値を確認するために参照するが、変更は禁止

以下の分類に基づいて、ファイル・ディレクトリの扱いを明確に区別してください。

読み取り専用（AI/人間が参照するが改変しないこと）

lib/Baser/（baserCMS のコア）
lib/Cake/（CakePHP 本体）

設定調査用（内容の把握目的。値の取得などには使うが変更禁止）

app/Config/database.php（接続設定の確認）
app/Config/core.php（ルーティング・デバッグ設定などの調査）
app/Console/cake（CLI の仕様確認）
app/webroot/index.php, .htaccess（起動ファイル・Rewrite設定）

サーバ構成・制約（baserCMS4固有）

共通ルールのサーバ構成・制約も参照してください。

baserCMS はドキュメントルート配下に配置（index.php がルート）

制約・注意点

baserCMS の標準構成に準拠したカスタマイズが基本（コアハック禁止）
Laravel や CakePHP 4系など、他フレームワークへの置き換え提案は不要
モダン JS フレームワーク（Vue, React など）に関する提案も不要
検討や提案を行う場合は、既存構成との互換性と影響を最優先に考慮すること
PHP 7.2の制約を考慮した実装を心がける
jQuery 1.x〜3.xの互換性を保つ
MySQL 5.7〜8.0の両方で動作するSQL文を使用

同仓库更多 Skills

同仓库

basercms-plugin-4-to-5-upgrade

baserproject/basercms

baserCMS 4 (CakePHP 2ベース) のプラグイン内部コードを baserCMS 5 (CakePHP 5ベース) へ移行する際の、Controller/Table/Entity/View/Helper/フォーム/Vue・JS の具体的な書き換えパターン集。「プラグインを4から5へ移行」「admin_ メソッドを Controller/Admin へ」「public $belongsTo/$hasMany を initialize() へ」「ClassRegistry/TableRegistry」「find(all/first/list, 配列) をクエリビルダへ」「$this->Model（null）を fetchTable へ」「getControlSource の単数→複数形」「$this->Form を BcAdminForm・control() へ」「検索フォーム searches/→search/」「FormHelper::create 文字列モデル→null」「FormHelper::year()/month()/domId() 廃止」「Time::format の ICU パターン」「Number::format/Text::truncate の null 不可」「配列条件の IN 自動付与なし・null は IS」「Vue/JS の admin URL を $.bcUtil.adminBaseUrl へ＋webpack 再ビルド」「$this->data / $View->request がヘルパ誤ロードを誘発」「MissingTableClassException / MissingHelperException / No context provider found」等、プラグインの画面・モデル・テンプレート・フロント表示のエラーを1つずつ潰す作業で参照する。本スキルは4系イディオムの検出と変換に絞り、5系での正しい書き方の正本は basercms5-plugin-development を参照する。サイト全体の4→5移行手順（インストール/DB移行/テーマ・プラグイン変換手順/Git運用）は basercms4-to-5-upgrade、テーマ（templates 中心）の移行は basercms-theme-4-to-5-upgrade、5.2→5.3 のプラグイン移行は

2026-07-05193

basercms-theme-4-to-5-upgrade

baserproject/basercms

baserCMS 4 のテーマ（templates/layout・element・Blog/Pages/Mail テンプレート＋少数の Helper で構成）を baserCMS 5 のテーマプラグインへ移行する際のパターン集。「テーマを4から5へ移行」「BcAddonMigrator でテーマ変換後の手修正」「siteConfig[] 廃止」「fullUrl() 廃止」「blogPosts() 等ショートカットメソッドの実在確認」「メールフォームテンプレートの移行（Mailform→BcBaser mailForm系）」「ウィジェット element の widgets→widget」「ビュー変数が空」「params[Content] 廃止」「css()/js() の inline 第2引数化」「アイキャッチ画像404」「サブディレクトリ設置でURLの base が欠ける」等で参照する。テーマ固有の移行パターン（TH-系）と、フロント表示エラーのうちテンプレート・テーマ描画系の実例パターン（F-系）を収録。本スキルは4系イディオムの検出と変換に絞り、5系テーマの正しい書き方の正本は basercms5-theme-development を参照する。プラグイン内部コード（Controller/Table/Entity/管理画面）は basercms-plugin-4-to-5-upgrade、サイト全体の手順は basercms4-to-5-upgrade、テスト実行は basercms-unittest スキルを参照。

2026-07-05193

basercms-unittest

baserproject/basercms

baserCMS（CakePHP5 / PHPUnit）のユニットテストをローカル Docker 環境で実行・調査する手順。「ユニットテストを実行して」「全テストを走らせて」「このテストだけ流して」「テスト失敗を調べて」「プラグイン単体でテストを動かしたい」「プラグインにテスト環境を導入したい」等のときに参照する。コンテナ名・実行コマンド・権限自動承認のためのコマンド整形・失敗の集計と切り分け方に加え、プラグイン単体（スタンドアロン）でユニットテストを実行する仕組みの導入手順（composer.json / phpunit.xml.dist / tests/bootstrap.php / TestApp 一式、phinx 0.16.10 ピンの罠）を収録。

2026-07-05193

basercms4-to-5-upgrade

baserproject/basercms

baserCMS 4 (CakePHP 2ベース) のコード・サイトを baserCMS 5 (CakePHP 5ベース) へアップグレード／移行する際に AIエージェントが遵守すべきルールとパターン集。「baserCMS 4 から 5 へ移行」「4系を5系にアップグレード」「BcDbMigrator でデータ移行」「BcAddonMigrator でテーマ／プラグイン変換」「CakePHP 2 → CakePHP 5 への書き換え」「admin_ プレフィックスメソッドの Controller/Admin への移動」「config/setting.php・config.php の return 配列化」「init.php 廃止と PluginClass 作成」「migration_snapshot 生成」「site_configs theme → sites theme」「移行の標準フロー／工程の順序」「プラグインを DB で直接有効化」「テーマを DB で直接適用」「request->data／query／params の getter 化」「File/Folder クラス廃止」「ClassRegistry → TableRegistry」「FrozenTime → DateTime」「FixtureManager → FixtureFactory」等、4→5 アップグレード作業全般で参照する。プラグイン内部コード（Controller/Table/Entity/View/Helper/フォーム/Vue・JS）の具体的な書き換えパターンは basercms-plugin-4-to-5-upgrade、テーマ（templates 中心）の移行は basercms-theme-4-to-5-upgrade、5.2→5.3 のプラグイン移行は basercms-plugin-5x-update、CakePHP本体起因は cakephp-migration、PHP本体起因は php-migration、テスト実行は basercms-unittest スキルを参照。移行先である5系での正しい書き方（開発の正本）は basercms5-plugin-development / basercms5-theme-development を参照。

2026-07-05193

basercms5-claude-workflow-setup

baserproject/basercms

baserCMS5（CakePHP5）の開発・移行を Claude Code で進めるときに、着手前に一度参照する「推奨ワークフロー環境セットアップ」スキル（提案ベース・実行は opt-in）。「5系プラグインの開発や移行をこれから始める」「どう進めるのがベストか」「設計→計画→実装の進め方/環境を整えたい」「パーミッションを整理して Auto mode で進めたい」等のときに最初に参照する。superpowers brainstorming での設計、permissions-audit でのパーミッション整理、その上での Auto mode 利用、spec/plan の Markdown プレビュー、brainstorming→plan プレビュー→spec 書き出しの順序を、強制せず"提案"する（やるかはユーザー判断、既に整っていればスキップ）。技術的な実装パターンは basercms5-plugin-development / basercms5-theme-development（共通ルールは basercms5-development）、移行の書き換えは basercms-plugin-4-to-5-upgrade / basercms-plugin-5x-update、テスト実行は basercms-unittest を参照。

2026-07-05193

basercms5-custom-content-development

baserproject/basercms

baserCMS 5系の標準プラグイン bc-custom-content（カスタムコンテンツ）でコンテンツ種別を新規構築・改修する際の正本パターン集。「custom_table/custom_fields/custom_links/custom_contents/custom_entries の関係」「CustomTablesService/CustomFieldsService/CustomLinksService/CustomContentsService/CustomEntriesService の使い方」「custom_fields.name はテーブル横断でグローバルユニーク」「フィールド名は ^[a-z0-9_]+$ のみ（camelCase不可）」「BcCcText/BcCcTextarea/BcCcSelect/BcCcRadio/BcCcDate/BcCcPref 等フィールドタイプ別のエスケープ挙動」「display_front の設定漏れ」「custom_entries.name が NULL だと詳細ページが404になる」「フロントテンプレート(templates/CustomContent/<template>/{index,view,archives,year}.php)のビュー変数」「bc-custom-contentは既存blog_postsへの後付けフィールド追加には使えない」で参照する。プラグイン開発の共通ルールは basercms5-plugin-development を参照。

2026-07-05193

name	basercms4-development
description	baserCMS 4系（CakePHP 2.10ベース）＋ jQuery プロジェクトの開発ルール集。「baserCMS 4 で開発」「4系のプラグインを修正」「CakePHP 2系のコードを書く」「app/Plugin 配下の Controller／Model／View」「テーマの Elements／Layouts」「BcBaserHelper／BcFormHelper／BcHtmlHelper の利用」「CakeLog でログ出力」「lib/Baser・lib/Cake はコアハック禁止」等、baserCMS 4系プロジェクトのコーディング方針・ディレクトリ構成・命名規則・ログ／エラーハンドリング・読み取り専用ファイルの扱い・サーバ制約を確認する際に参照する。baserCMS 5系の開発は basercms5-development、4→5 へのアップグレードは basercms4-to-5-upgrade スキルを参照。
license	MIT

baserCMS4系（CakePHP2系）＋ jQuery プロジェクトの開発ルール

このプロジェクトでは、以下の技術スタックおよび設計方針に従って開発されています。

使用技術

baserCMS 4系 を使用（内部的には CakePHP 2.10 ベース）
バックエンド：PHP 7.4 〜 8.2 / CakePHP 2系
データベース：MySQL 5.7 〜 8.0
フロントエンド：jQuery 1.x〜3.x（プロジェクト内で複数バージョンが混在している可能性あり）
HTTPサーバ：Apache（mod_rewrite 有効）

ディレクトリ構成のルール

MVC構成は CakePHP 2系に準拠しつつ、baserCMSでは主にプラグイン単位で構築されている
- app/Plugin/{Plugin名}/Controller/, Model/, View/ にそれぞれ配置される
共通パーツ（ヘッダー、フッターなど）は、テーマ内の Elements/ ディレクトリに配置
- 主に：theme/{テーマ名}/Elements/
- 一部環境では：app/webroot/theme/{テーマ名}/Elements/
レイアウトもテーマ内に配置される
- 主に：theme/{テーマ名}/Layouts/
- 一部環境では：app/webroot/theme/{テーマ名}/Layouts/
- $this->layout により切り替えが可能
管理画面系は /admin/ プレフィックスのURLルーティングで制御
- 使用ファイル：app/Config/core.php
- 定義内容：Configure::write('Routing.prefixes', array('admin'));

コーディング方針（baserCMS4固有）

共通ルールのコーディング方針も参照してください。

クラスベースよりも関数ベース・手続き的なコードが多く採用されている
JavaScript は Viewファイル内の <script> タグ内または .js ファイルに記述
Ajax通信は jQuery（$.ajax()）を用いて行う
ES6構文（Promise, fetch, import/export）は使用しない
フロント実装に React や Vue などの SPA 技術は導入していない
- 一部、部分的に利用している箇所がある

命名規則（baserCMS4固有）

共通ルールの命名規則も参照してください。

※ baserCMSやCakePHPの命名慣習（Controller, Helper, Modelなど）はそのまま準拠する

ログ・エラーハンドリング方針（baserCMS4固有）

共通ルールのログ・エラーハンドリング方針も参照してください。

目的： /log エイリアスや、例外処理実装時の提案精度向上

baserCMS4固有の実装方法

PHPでは CakeLog::error() または error_log() を利用
JavaScriptでは console.error() を暫定対応とし、本実装時はサーバ送信も検討

実装例（baserCMS用で設定ファイルに記述）：

/**
 * 専用ログ
 */
if (!defined('PROJECT_PLUGIN_ACTION')) {
	define('PROJECT_PLUGIN_ACTION', 'project_plugin_action');
	CakeLog::config('project_plugin_action', [
		'engine' => 'FileLog',
		'types' => ['project_plugin_action'],
		'file' => 'project_plugin_action',
		'size' => '5MB',
		'rotate' => 5,
	]);
}

// ログを取りたい箇所に記述する
$this->log('Start', PROJECT_PLUGIN_ACTION);
$this->log(print_r($array, true), PROJECT_PLUGIN_ACTION);

使用ライブラリとヘルパー

BcBaserHelper, BcFormHelper, BcHtmlHelper など baserCMS 固有ヘルパーを活用
HTML の出力は $this->BcBaser->css(), $this->BcBaser->img() などを使用し、手書きは控えめにする

ファイル・ディレクトリに関する扱いルール

目的： AIがコードを解析・提案する際に、以下の3つの分類に基づいて適切に扱うことで、不要な提案や誤った変更を防ぎます。

読み取り専用：フレームワークのコアファイルなど、参照はするが変更は禁止
設定調査用：設定値を確認するために参照するが、変更は禁止

以下の分類に基づいて、ファイル・ディレクトリの扱いを明確に区別してください。

読み取り専用（AI/人間が参照するが改変しないこと）

lib/Baser/（baserCMS のコア）
lib/Cake/（CakePHP 本体）

設定調査用（内容の把握目的。値の取得などには使うが変更禁止）

app/Config/database.php（接続設定の確認）
app/Config/core.php（ルーティング・デバッグ設定などの調査）
app/Console/cake（CLI の仕様確認）
app/webroot/index.php, .htaccess（起動ファイル・Rewrite設定）

サーバ構成・制約（baserCMS4固有）

共通ルールのサーバ構成・制約も参照してください。

baserCMS はドキュメントルート配下に配置（index.php がルート）

制約・注意点

baserCMS の標準構成に準拠したカスタマイズが基本（コアハック禁止）
Laravel や CakePHP 4系など、他フレームワークへの置き換え提案は不要
モダン JS フレームワーク（Vue, React など）に関する提案も不要
検討や提案を行う場合は、既存構成との互換性と影響を最優先に考慮すること
PHP 7.2の制約を考慮した実装を心がける
jQuery 1.x〜3.xの互換性を保つ
MySQL 5.7〜8.0の両方で動作するSQL文を使用