Run any Skill in Manus with one click

basercms4-development

Stars193

Forks141

UpdatedJuly 3, 2026 at 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 スキルを参照。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

baserproject

baserproject/basercms

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

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文を使用

More from this repository

same repository

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文を使用