Communitygithub.com

patdhlk/skills

エージェントワークフロースキル(sphinx-needs 対応の課題、要件、ADR を備えた、mattpocock/skills のドロップイン代替)

skills とは?

このスキルは、AI エージェント(Claude Code、Cursor、Codex など)が開発プロジェクト内で構造化されたワークフローを実行できるようにするための、ドロップイン代替可能なスキルセットです。元の mattpocock/skills と完全互換でありながら、裏側では sphinx-needs を利用して課題(issues)、要件(requirements)、アーキテクチャ決定記録(ADRs)を一元管理します。これにより、従来のスキルと同じコマンドやインターフェースで、より堅牢なトレーサビリティとドキュメント生成が可能になります。主に Claude Code、Cursor、Codex などのエージェント向けに設計されており、開発チームはコードベースとともに進化する生きたドキュメントを維持できます。エージェントは sphinx-needs のデータ構造を直接操作し、変更を自動的に追跡・反映するため、手動更新の手間が省けます。

対応~Claude Code~Codex CLI~Cursor
npx skills add patdhlk/skills

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

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

ドキュメント

skills は何をしますか?

エージェントワークフロースキル — sphinx-needs 対応の課題、要件、ADR を備えた、mattpocock/skills のドロップイン代替

概要

このスキルは、AI エージェント向けのワークフロー機能を提供します。mattpocock/skills と完全互換のインターフェースを持ちながら、バックエンドに sphinx-needs を採用しています。課題、要件、アーキテクチャ決定記録(ADR)を構造化データとして管理し、トレーサビリティと自動ドキュメント生成を実現します。

機能

  • 課題管理: 課題の作成、一覧表示、状態変更、コメント追加
  • 要件管理: 要件の定義、親子関係の設定、カバレッジの追跡
  • ADR 管理: アーキテクチャ決定の記録、ステータス管理、変更履歴の保持
  • 互換性: mattpocock/skills と同じコマンドとワークフローをそのまま使用可能
  • 自動ドキュメント生成: sphinx-needs により、プロジェクトドキュメントを自動生成

対応エージェント

  • Claude Code
  • Cursor
  • Codex
  • その他、カスタムエージェント(API 経由で利用可能)

インストール

# スキルをクローン
$ git clone https://github.com/patdhlk/skills.git

# 依存関係をインストール
$ pip install sphinx sphinx-needs

使用方法

エージェントに対して以下のような指示を出します。

新しい要件を追加してください 課題 #42 にコメントを追加 ADR を承認ステータスに変更

詳細は SKILL.md を参照してください。

関連スキル