메뉴
作業進捗をGitHub issueに自動報告します。計画立案時、知見獲得時、問題発覚時にブランチ名からissue番号を抽出し、構造化されたコメントを投稿します。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | issue-reporter |
| description | 作業進捗をGitHub issueに自動報告します。計画立案時、知見獲得時、問題発覚時にブランチ名からissue番号を抽出し、構造化されたコメントを投稿します。 |
| allowed-tools | Bash Grep Read |
このスキルは、作業進捗を関連するGitHub issueに自動報告します。
以下の状況で自動起動します：
gh CLIがインストールされ認証済みであることブランチ命名規則の詳細は
.claude/git-conventions.mdを参照してください。
標準パターン（推奨）:
| パターン例 | 抽出結果 |
|---|---|
feat/121-xxx | 121 |
fix/121-xxx | 121 |
refactor/123-xxx | 123 |
docs/101-xxx | 101 |
test/111-xxx | 111 |
chore/222-xxx | 222 |
レガシーパターン（後方互換性）:
| パターン例 | 抽出結果 |
|---|---|
feature/111-xxx | 111 |
bugfix/456-xxx | 456 |
# 現在のブランチ名を取得
branch=$(git branch --show-current)
# issue番号を抽出（標準パターン + レガシーパターン対応）
issue_number=$(echo "$branch" | sed -n 's#^\(feat\|fix\|chore\|docs\|refactor\|test\|feature\|bugfix\)/\([0-9]\+\)-.*#\2#p')
# 先頭ゼロを除去（004 -> 4）
if [ -n "$issue_number" ]; then
issue_number=$((10#$issue_number))
fi
## 📋 実装計画
**作業内容**: [作業の概要]
### 計画
1. [ステップ1]
2. [ステップ2]
3. [ステップ3]
### 予想される課題
- [課題1]
- [課題2]
---
*Posted by Claude Code at YYYY-MM-DD HH:MM*
## 💡 新たな知見
**発見内容**: [発見の概要]
### 詳細
[発見の詳細説明]
### プロジェクトへの影響
- [影響1]
- [影響2]
### 推奨アクション
- [ ] [アクション1]
- [ ] [アクション2]
---
*Posted by Claude Code at YYYY-MM-DD HH:MM*
## ⚠️ 問題発覚
**問題**: [問題の概要]
### 詳細
[問題の詳細説明]
### 再現手順
1. [手順1]
2. [手順2]
### 暫定対応
- [対応1]
### 根本対応（提案）
- [ ] [対応提案1]
---
*Posted by Claude Code at YYYY-MM-DD HH:MM*
## 📝 作業メモ
**内容**: [内容の概要]
### 詳細
[詳細説明]
---
*Posted by Claude Code at YYYY-MM-DD HH:MM*
branch=$(git branch --show-current)
issue_number=$(echo "$branch" | sed -n 's#^\(feat\|fix\|chore\|docs\|refactor\|test\|feature\|bugfix\)/\([0-9]\+\)-.*#\2#p')
if [ -n "$issue_number" ]; then
issue_number=$((10#$issue_number))
fi
gh issue view "$issue_number" --json state,title 2>/dev/null
gh issue comment "$issue_number" --body "$comment_body"
issue番号が検出できないブランチ（main, develop等）の場合は、ブランチ切り替えを提案します：
⚠️ issue番号が検出できません
現在のブランチ: main
issueに紐づいたブランチに切り替えることを推奨します。
対応中のissueがある場合:
git checkout -b feat/<issue番号>-<説明>
例:
git checkout -b feat/121-fix-embed-error
⚠️ Issue #XXX が見つかりません
ブランチ名から抽出したissue番号に対応するissueが存在しません。
考えられる原因：
- issueが削除された
- issueが別のリポジトリにある
- ブランチ名のフォーマットが想定と異なる
現在のブランチ: [branch_name]
抽出したissue番号: [issue_number]
⚠️ GitHub CLI認証が必要です
gh CLIの認証が必要です。以下のコマンドで認証してください：
gh auth login
その後、再度コメントを投稿できます。
スキルは以下の状況を検知して自動的に報告します：
| シナリオ | 報告タイプ |
|---|---|
| TodoWriteで複数タスクを作成した直後 | Plan |
| API仕様・実装パターンを発見した際 | Insight |
| テスト失敗の原因を特定した際 | Problem |
| ブロッカーを発見した際 | Problem |
| 設計変更を決定した際 | Insight |
以下の場合はコメントを投稿しません：
gh issue comment 121 --body "$(cat <<'EOF'
## 📋 実装計画
**作業内容**: note.com埋め込みサーバーエラーの修正
### 計画
1. エラー発生箇所の特定（api/v1/embed）
2. レスポンス形式の調査
3. エラーハンドリングの実装
4. E2Eテストの追加
### 予想される課題
- 埋め込みAPIの仕様が非公開
- レート制限の可能性
---
*Posted by Claude Code at 2026-01-13 10:30*
EOF
)"
gh issue comment 121 --body "$(cat <<'EOF'
## 💡 新たな知見
**発見内容**: 埋め込みAPIはキーを使用してリゾルブする必要がある
### 詳細
`api.note.com/v1/embed/resolve` エンドポイントは、
note_keyを使用してURLから埋め込み可能なコンテンツを取得します。
レスポンス形式:
```json
{
"data": {
"html": "<iframe...>",
"provider_name": "YouTube"
}
}
Posted by Claude Code at 2026-01-13 11:45 EOF )"
## 注意事項
- **機密情報を含めない**: APIキー、認証情報、個人情報をコメントに含めない
- **簡潔に**: 長すぎるコメントは避け、要点を絞る
- **構造化**: テンプレートに従って構造化されたコメントを作成
- **タイムスタンプ**: コメントには必ずタイムスタンプを含める
## チェックリスト
コメント投稿前に確認：
- [ ] ブランチにissue番号が含まれているか
- [ ] issueが存在し、アクセス可能か
- [ ] コメント内容が適切なテンプレートに従っているか
- [ ] 機密情報が含まれていないか
- [ ] 重複したコメントではないか
note.com APIの調査を支援します。mitmproxyとPlaywrightを使用してHTTPトラフィックをキャプチャ・分析し、API動作を解明します。
コード品質基準の完全遵守を保証します。コミット前の品質チェックを自動実行し、エラーがある状態でのコミットを防止します。
プロジェクト憲法への準拠を検証します。実装完了時やPR作成時に全Articleをチェックし、違反がないことを確認します。
コード変更、API変更、新機能追加時にドキュメントを自動更新します。公開APIやインターフェースの変更、新クラス・関数・モジュールの追加、アーキテクチャの重要な変更、ユーザーからの明示的なドキュメント更新依頼時に起動します。プロジェクトのドキュメント標準に準拠した更新を提案します。
MCPサーバー開発を支援します。プロトコル準拠、Pydanticスキーマ設計、Playwright統合のベストプラクティスを提供します。
TDDワークフローを強制し、テストファースト開発を支援します。新機能実装時に自動起動し、Red-Green-Refactorサイクルを確実に実行します。