Dev Cycle

dev-cycle — コード品質改善サイクル

ユーザーが /dev-cycle を呼び出したら、まず以下を確認する:

どのフェーズから始めますか？
  [1] 品質スイープ（全ファイル走査・問題列挙）
  [2] コードレビュー v3（重要ファイルを深く評価）
  [3] Issue化（レビュー結果をGitHub Issueに登録）
  [4] 自律実装ループ（Issueを順番に自動実装）
  [all] 全フェーズ通し実行
  
対象プロジェクト: ?

小規模（変更ファイル少）→ フェーズ2から推奨 大規模（50件超の改善）→ フェーズ1から推奨

フェーズ1: 品質スイープ 🟡[GLM]

目的: 全ファイルを機械的に走査し High/Medium/Low リストを作る（読み取り専用）

実行方法: CronCreate（20分間隔）または今すぐ実行
テンプレート: 00_SYSTEM/共通ルール/コード品質スイープ.md を参照
出力先: 01_DECISIONS/<project>/YYYY-MM-DD_リファクタリング調査_<area>.md

LLM: 🟡[GLM]（パターン検出・列挙）

フェーズ2: コードレビュー v3 🟡[GLM] / 🔵[Sonnet]（許可時）

目的: 重要ファイルを深く読み、★スコア + P1/P2 改善提案を出力

手順:
1. python score-files.py <project_path> --top 20 --json
2. wc -l で行数実測（スコアと照合）
3. Read ツールで実際に読む
4. 🟡[GLM] または 🔵[Sonnet] で評価
5. 出力: 40_CAREER/キャリア分析/02_コード品質/YYYY-MM-DD_<内容>/_REPORT.md

テンプレート: 00_SYSTEM/プロンプト集/コードレビュー/code-review-v3.md を参照

LLM: 🟡[GLM]（主観的評価・深い読解が必要なため MiniMax は使わない）

フェーズ3: Issue化 🟡[GLM]

目的: P1/P2 リストを GitHub Issues に自動登録

# GitHub API で Issue 一括作成
import yaml, json, urllib.request
hosts = yaml.safe_load(open('/home/yn4416/.config/gh/hosts.yml'))
token = hosts['github.com']['oauth_token']

issues_to_create = [
    # レビュー結果の P1/P2 からここを埋める
    {"title": "test: [A] ...", "body": "...", "labels": ["type:test","priority:low"]},
    {"title": "fix: [B] ...",  "body": "...", "labels": ["type:test","priority:medium"]},
]

for issue in issues_to_create:
    data = json.dumps(issue).encode()
    req = urllib.request.Request(
        f'https://api.github.com/repos/fukukei23/<REPO>/issues',
        data=data,
        headers={'Authorization': f'token {token}', 'Content-Type': 'application/json'}
    )
    res = json.load(urllib.request.urlopen(req))
    print(f"Created #{res['number']}: {res['title']}")

タイトル形式:

• [A] = priority:low（1h以下）
• [B][C] = priority:medium（2-3h）
• [D] = priority:high（4h以上）

ラベル: type:test / type:fix / priority:high|medium|low

フェーズ4: 自律実装ループ

目的: GitHub Issues を高→中→低の順に自動実装

今すぐ実行（Stop Hook 連鎖方式）

⚠️ 旧start.sh方式は廃止済み（2026-06-29・詳細: 00_SYSTEM/共通ルール/自律開発ループ.md補足）。 現行はDaily Triage → 人間承認（approve.py）→ 最初のタスクが run-task.sh で起動 → 以降 Stop hook 連鎖（next_issue.py）。

# 手動承認フロー（today-tasks.md の候補を選んで起動・大量一括承認は禁止）
python3 /home/yn4416/projects/claude-config/scripts/auto-dev/approve.py

# OSS Issue自律ループ（auto-loopラベル付きIssueをキューに積込→auto切替）
python3 /home/yn4416/projects/claude-config/scripts/auto-dev/fetch_issues.py <repo>
bash /home/yn4416/projects/claude-config/scripts/auto-dev/set-mode.sh auto

夜間・放置実行（CronCreate 方式）

CronCreate:
  schedule: "7 * * * *"    # 毎時:07
  durable: true
  prompt: <repo>/docs/autonomous-loop-prompt.md の内容

実装中のLLM割り当て

完了後の自動処理（自動実行される）

1. pytest 全件パス確認
2. git commit && git push
3. gh run watch で CI 確認
4. Issue close（GitHub API）
5. 次の Issue へ（Stop Hook 連鎖）
6. 全完了時 → Discord 通知

緊急停止

python3 -c "
import json; p='/home/yn4416/projects/claude-config/scripts/auto-dev/state.json'
s=json.load(open(p)); s['active']=False; json.dump(s,open(p,'w'),indent=2)
print('停止:', s)
"

状態確認

cat /home/yn4416/projects/claude-config/scripts/auto-dev/state.json
tail -f /home/yn4416/projects/claude-config/scripts/auto-dev/loop.log

⚠️ 既知の制約（Windows Desktop・未解消）: approve.py/run-task.sh/next_issue.py/set-mode.sh/fetch_issues.py/state_store.py の6スクリプトは いずれも内部で state.json/loop.log 等の実データファイルパスを /home/yn4416/.claude/scripts/auto-dev/...（シンボリックリンク経由）に ハードコードしており、Windows Desktop環境のUNCアクセスではこの内部参照が解決できない（Not a directory）。 上記のSKILL.md側コマンドを実体パスに直しても、スクリプト自身の内部パスが直っていないため現状フェーズ4はWindows Desktop環境では動作しない。 根本修正には上記6スクリプトのハードコードパスを実体パス化する必要があるが、WSL側cron（Daily Triage等）が使う本番稼働中のstate.jsonを扱うため、 影響範囲の大きい別タスクとして切り出すことを推奨（2026-07-11調査で判明）。WSL-CLI環境では問題なく動作する（実体は同一ファイルのため挙動不変）。

フェーズ5: 完了通知（自動）

next_issue.py（Stop Hook 本体）が pending=[] を検知して自動実行。 Discord Webhook に完了メッセージを送信する。

関連ファイル