メニュー
作業完了前にセッション内の改善ポイントを抽出し、ユーザー承認後にルール・スキル・ドキュメントへ反映する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
プッシュ前に必ず実行。静的チェック・テスト・統合レビュー含む6ペルソナレビューを最低2サイクル実施し、自己改善確認後のみpush可能。
Git worktree を使った並列開発時に使用。配置・ポート割当・環境コピー・クリーンアップを標準化する。
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
開発サーバー・E2E・ブラウザ検証時に使用。既存プロセスを停止してからプロジェクト指定ポートで起動し、作業後に必ず停止する。
Use when creating new skills, editing existing skills, or verifying skills work before deployment
機能・サービス・要件・前提条件などプロジェクトの知識をドキュメント化する。新規機能/サービスを作るとき、または既存機能を変更するときに必ず実行。新規ならドキュメントを作成、既存があれば更新する。
| name | self-improvement |
| description | 作業完了前にセッション内の改善ポイントを抽出し、ユーザー承認後にルール・スキル・ドキュメントへ反映する。 |
セッション中に見つかったハーネス・ルール・スキルの改善点を、作業完了前にユーザーへ提示し、承認された内容だけを同じブランチ内で反映する。
改善は次回以降の作業品質を高めるための恒久対応として扱う。一時的な回避策や場当たり的なルール追加は禁止する。
quality-check の最終段階、.quality-check-passed を作成する前に必ず実行する。
以下のタイミングでも必要に応じて実行する:
セッションで発生した事実から、改善候補を抽出する。
候補にしてよいもの:
候補にしてはいけないもの:
各候補を反映先ごとに分類する。
| 反映先 | 使う条件 |
|---|---|
CLAUDE.md / AGENTS.md / .cursorrules | AI の基本動作、確認条件、自律性、品質ゲートに関する改善 |
documents/development/coding-rules/ | 実装規約、命名、設計、テスト、セキュリティなどのプロジェクトルール |
skills/project/*/SKILL.md | 手順化すべき運用、品質チェック、サーバー起動、ブランチ運用 |
.github/review-*.md | レビュー観点やチェックリストの追加 |
| README / docs | 利用者向け説明、セットアップ手順、FAQ |
改善候補は必ずユーザーに提示し、適用可否を確認する。
提示形式:
作業完了前の自己改善候補です。適用するものを選んでください。
1. [反映先] 改善タイトル
根拠: セッション中に発生した事実
変更案: どのファイルに何を追加・修正するか
期待効果: 次回以降どう改善されるか
適用 / 見送り / 内容修正
ユーザーが見送った候補は適用しない。判断材料が不足している候補は、調査してから再提示する。
承認された改善のみ、現在作業中の同じブランチ内で反映する。
適用時のルール:
.quality-check-report.json に self_improvement フィールドを記録する。
{
"self_improvement": {
"status": "applied",
"candidates": [
{
"title": "サーバー停止確認を必須化",
"target_files": ["skills/project/server-startup/SKILL.md"],
"decision": "applied",
"reason": "E2E後の停止確認が曖昧だったため"
}
]
}
}
候補がない場合:
{
"self_improvement": {
"status": "not_required",
"candidates": []
}
}
.quality-check-report.json に結果を記録した