taika-izumi

extend-guidelines

"ガイドラインの拡張(原則追加・Skillの新規作成/改定・AGENTS.md更新)を行う際のゲートウェイ。CONTRIBUTING.mdを読み込み、brainstormingへ接続する。"

taika-izumi 0 Updated 22h ago
GitHub

Install

npx skillscat add taika-izumi/ai-driven-dev-principles/dist-skills-extend-guidelines

Install via the SkillsCat registry.

SKILL.md

extend-guidelines

AI駆動開発ガイドラインの拡張作業を自動的にガイドするゲートウェイスキル。

手順

1. CONTRIBUTING.md を読み込む

まず、リポジトリルートの CONTRIBUTING.md を読み込み、設計思想と拡張ルールを把握すること。

このファイルが見つからない場合は、ユーザーに以下を報告して作業を中断する:
CONTRIBUTING.md が見つかりません。拡張ルールの参照元が存在しないため、作業を開始できません。」

2. 拡張内容をヒアリングする

ユーザーに「何を拡張したいか」を確認する。以下の選択肢を提示すること:

  • 原則を追加・変更したい
  • AGENTS.md を更新したい
  • 新しいSkillを作成したい
  • 既存のSkillを改定したい

3. 該当シナリオを確認する

CONTRIBUTING.md の該当シナリオセクションを読み、判定基準・手順・チェックリストを確認する。
ユーザーの要望が判定基準に合致するか検証し、合致しない場合はその旨を伝える。

4. brainstorming を開始する

ユーザーの要望と CONTRIBUTING.md の拡張ルールをコンテキストとして保持したまま、brainstorming スキルを呼び出す。brainstorming では以下を念頭に置く:

  • CONTRIBUTING.md の判定基準とチェックリストを設計の制約として扱う
  • 既存の原則・指示・スキルとの整合性を確認する
  • ADRの作成が必要かどうかを判断する(CONTRIBUTING.md「ADRを記録するとき」セクション参照)

5. 確定前の過剰適合点検

設計承認の前に、CONTRIBUTING.md の次の共通節(「全シナリオ共通: 過剰適合の点検」、新設を含む拡張では「全シナリオ共通: 新設の評価可能性」もあわせて)を実施・確認し、各節の記録義務・執行点に従って点検結果を記録すること。点検の観点・記録先・執行点の定義は CONTRIBUTING.md 側が正である。

6. 配布更新を実施する

本手順はガイドライン本体のリポジトリで拡張作業を行う場合のみ該当する(配布先プロジェクトには生成器も配布対象ソースも存在しない)。

配布する変更の実装・必要なレビュー・検証が済んだ時点で本手順へ戻り、CONTRIBUTING.md「全シナリオ共通: 配布対象ソースの記法規約」の「配布プラグインの版更新」と「執行点」に従って配布更新を実施する。版更新の条件・公開前後の追加修正の扱い・対象別の生成・検証・コミットは同文書を正本とし、ここには複写しない。

作業中の配布対象ソース変更でも、コミット前の生成・検証は同じ「執行点」に従って実施する。途中のCheck合格と、配布する内容の版更新まで済んだ状態を区別して報告する。

Categories