berlinguyinca/autospec

autospec は何をしますか？

仕様書をGitHubイシューツリー、モデルサイズの実装タスク、自律的なPR、そして引用付きリポジトリストーリー/状態レポートに変換するためのAIワークフロースキル。Codex、Claude Code、OpenCodeで利用可能。

概要

autospecは、ソフトウェア開発におけるAIエージェントのワークフローを標準化し、効率化します。このスキルを使用することで、人間は高レベルの仕様書を提供するだけで、AIエージェントが自動的に以下のことを行います。

• 仕様書から具体的な実装タスクを抽出し、GitHubイシューとして整理します。
• 各タスクをAIモデルが処理しやすい適切なサイズに分割します。
• タスクの依存関係を考慮したイシューツリーを生成します。
• 実装を自律的に進め、コードレビュー可能なプルリクエストを作成します。
• プロジェクトの進行状況や状態を要約したレポートを生成します。

対応プラットフォーム

• Codex (OpenAI)
• Claude Code (Anthropic)
• OpenCode (オープンソース)

使い方

前提条件

• 各AIエージェントプラットフォームのセットアップが完了していること。
• GitHubリポジトリへの適切なアクセス権限があること。

基本的なワークフロー

1. 仕様書の準備: 実装したい機能の仕様書をマークダウン形式で準備します。
2. スキルの呼び出し: AIエージェント上でautospecスキルを有効にし、仕様書を入力します。
3. イシューツリーの生成: スキルが仕様書を解析し、GitHubイシューツリーを自動生成します。
4. タスクの実行: 生成されたイシューに従ってAIエージェントが実装を開始します。
5. PRの作成: 各タスクの完了後、自律的にプルリクエストを作成します。
6. レポートの確認: プロジェクトの状態や進捗をレポートとして確認できます。

設定

スキルを使用する前に、以下の環境変数または設定ファイルで認証情報を設定してください。

GITHUB_TOKEN=<あなたのGitHub個人アクセストークン>

例

入力仕様書（例）

# ユーザー認証機能の実装

- メールアドレスとパスワードによるログイン
- Google OAuth 2.0によるソーシャルログイン
- JWTを使用したセッション管理
- パスワードリセット機能

生成されるイシューツリー（例）

• データベースユーザーモデルの作成
  • ユーザースキーマの定義
  • パスワードのハッシュ化処理の実装
• ログインAPIエンドポイントの実装
  • メール/パスワード認証ロジック
  • JWTトークン生成・検証ロジック
• Google OAuth認証の統合
  • Google認証プロバイダーの設定
  • コールバックURLの処理
• パスワードリセットフローの実装
  • リセットトークンの発行
  • リセットメールの送信
  • 新しいパスワードの設定

## ベストプラクティス

- 仕様書は具体的で明確に記述してください。
- 大きな機能は複数の小さな仕様書に分割することを推奨します。
- 生成されたイシューツリーは必要に応じて手動で調整できます。
- AIエージェントの動作を監視し、必要に応じて介入してください。

## ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は`LICENSE`ファイルを参照してください。

## 貢献

バグ報告や機能リクエストは、GitHubのIssuesまたはPull Requestsでお願いします。