Communityライティング&編集github.com

Aubertaaliphatic741/sdd-guardian

グローバルCodexスキルを使用してSDDドキュメントをガードおよび保守し、プロジェクト状態、ADR、ドキュメントパックをブートストラップします。

sdd-guardian とは?

このスキルは、ソフトウェア設計ドキュメント(SDD)を自動的にガードおよび保守するために設計されたグローバルCodexスキルです。プロジェクトの状態、アーキテクチャ決定記録(ADR)、およびドキュメントパックをブートストラップすることで、開発チームが一貫性のある最新の設計文書を維持できるようにします。主にCodexエージェントと連携して動作し、プロジェクトの初期化時や重要な設計決定が行われた際に、自動的にSDDを生成または更新します。このスキルを使用することで、手動によるドキュメント管理の手間を大幅に削減し、設計と実装の同期を保つことができます。Gitワークフローと統合可能で、プルリクエストやコミット時に自動的にドキュメントの整合性をチェックし、必要に応じて更新を提案します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add Aubertaaliphatic741/sdd-guardian

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

sdd-guardian は何をしますか?

グローバルCodexスキルを使用してSDDドキュメントをガードおよび保守し、プロジェクト状態、ADR、ドキュメントパックをブートストラップします。

このスキルは、プロジェクトの設計ドキュメント(SDD)を自動的に管理および保護するためのものです。以下の機能を提供します。

  • プロジェクト状態のブートストラップ: プロジェクトの初期化時に、現在のコードベースと設定から自動的に設計ドキュメントの初期状態を生成します。
  • アーキテクチャ決定記録(ADR)の管理: 重要な設計上の決定が行われた際に、ADRを自動的に作成または更新します。
  • ドキュメントパックの生成: 関連するドキュメントをパッケージ化し、簡単に参照できるようにします。

対応プラットフォーム

  • Codex エージェント
  • Git ワークフロー(プルリクエスト、コミットフック)

使用例

codex run sdd-guardian --bootstrap

これにより、現在のプロジェクトの設計ドキュメントが初期化されます。

詳細

スキルは、以下の環境変数によって設定を変更できます。

  • SDD_GUARDIAN_AUTO_UPDATE: 自動更新を有効にするかどうか(デフォルト: true)
  • SDD_GUARDIAN_ADR_PATH: ADRの保存先パス(デフォルト: docs/adr)

詳細な使用方法については、各プロジェクトのドキュメントを参照してください。

関連スキル