init-project-jpkb について
init-project-jpkbは、JPKBリポジトリ内で標準化された文書とディレクトリ構成を作るワークフロー型スキルです。要件やカテゴリを確認して既存ファイルを保持し、汎用、Python、Node.js、3Dプリント、研究向けの構成に対応します。
主な機能
- 01プロジェクトとカテゴリの要件確認
- 02作成先パスの確認
- 03既存ファイルの保持またはマージ
- 04テンプレートからのファイル生成
- 055種類のプロジェクト構成
活用シーン
- 01JPKBで文書付きプロジェクトを作成
- 02研究または3Dプリントのプロジェクトを構築
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ product-on-purpose/ pm-skills --skill init-project-jpkbインストール後、Claude Code で/init-project-jpkbを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/CHANGELOG.template.mdCONTEXT.template.mdDECISIONS.template.mdLICENSE-Apache2.txtLICENSE-MIT.txtREADME.template.mdTODO.template.mdgitignore-general.txtreferences/project-types.md詳細
JPKB プロジェクト初期化ワークフロー
JPKB リポジトリで、新しいプロジェクトの標準化されたドキュメント一式を作成します。
実行手順
1. 要件を確認する
ファイルを作成する前に、ユーザーに次の点を確認します。
| 必須 | 質問 | デフォルト |
|---|---|---|
| ✓ | プロジェクト名は何ですか? | なし — 必ず確認する |
| ✓ | カテゴリ/親フォルダーはどれですか? | 既存の選択肢を提示 |
| プロジェクトの種類は何ですか? | general | |
| 希望するライセンスはありますか? | MIT | |
| 簡単な説明を入力してください。 | 「新しいプロジェクト」 |
コンテキストから回答が分かる場合は、質問を省略します。 ユーザーが「init parametric-hinge in 3d-prints」と指定した場合は、再度確認しません。
2. 保存先パスを確認する
ファイルを作成する前に、完全なパスを確認します。
Target: E:\Projects\JP KB\jpkb\projects\<category>\<project-name>\
ユーザーの確認または修正を待ちます。
3. 既存ファイルを確認する
作成する前に、既存のファイルを確認します。
| 存在する場合 | 対応 |
|---|---|
| README.md | スキップ — 既存の内容を保持 |
| CHANGELOG.md | スキップ — 既存の内容を保持 |
| LICENSE | スキップ — 既存の内容を保持 |
| .gitignore | マージ — 不足している項目を追加 |
| _NOTES/ | スキップ — 既存の内容を保持 |
| AGENTS/ | 不足している部分のみ作成 |
これにより、既存のプロジェクトで安全に再実行して、エージェント向けの構成を追加できます。
4. ディレクトリ構成を作成する
<project-name>/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
├── _NOTES/
│ └── .gitkeep
└── AGENTS/
└── claude/
├── CONTEXT.md
├── TODO.md
├── DECISIONS.md
└── SESSION-LOG/
5. ファイルに内容を設定する
assets/ フォルダーのテンプレートを使用し、次の値を置き換えます。
{{PROJECT_NAME}}— プロジェクト名{{DESCRIPTION}}— プロジェクトの説明{{DATE}}— 現在の日付(YYYY-MM-DD){{YEAR}}— 現在の年{{CATEGORY}}— プロジェクトのカテゴリ
種類ごとのバリエーションについては、references/project-types.md を参照してください。
6. 完了を報告する
ユーザーに次の内容を報告します。
- 作成した完全なパス
- 生成したファイル
- 次のステップの提案
プロジェクトの種類
| 種類 | 追加される構成 | 使用するケース |
|---|---|---|
general | 基本構成のみ | デフォルト、ドキュメント |
code-python | + src/、tests/、pyproject.toml | Python プロジェクト |
code-node | + src/、package.json | Node.js プロジェクト |
3d-print | + models/、images/ | 3D プリントプロジェクト |
research | + data/、notebooks/ | 研究/データプロジェクト |
詳細については、references/project-types.md を参照してください。
テンプレートアセット
| ファイル | ソース |
|---|---|
| README.md | assets/README.template.md |
| CHANGELOG.md | assets/CHANGELOG.template.md |
| LICENSE(MIT) | assets/LICENSE-MIT.txt |
| LICENSE(Apache) | assets/LICENSE-Apache2.txt |
| .gitignore | assets/gitignore-general.txt |
| CONTEXT.md | assets/CONTEXT.template.md |
| TODO.md | assets/TODO.template.md |
| DECISIONS.md | assets/DECISIONS.template.md |
wrap-session との連携
このスキルは、/wrap-session が書き込む構成を作成します。
| Init が作成 | Wrap-Session が更新 |
|---|---|
| README.md(テンプレート) | README.md(進捗を記載) |
| CHANGELOG.md([Unreleased]) | CHANGELOG.md(変更を記載) |
| CONTEXT.md(初期状態) | CONTEXT.md(現在の状態) |
| TODO.md(空) | TODO.md(タスクを記載) |
| SESSION-LOG/(空) | SESSION-LOG/*.md |
コメント
Markdown 対応