메뉴
タスク実行の標準ワークフロー。plan.md のタスクを実行する際に必ず使用する。 「次のタスクを実行」「plan.md に従って進めて」「標準作業フローで」「タスクNを実施」 といった指示で発動する。git worktree での分離作業、品質ゲート（静的解析・テスト・ codex レビュー）、ユーザー確認、KPT ふりかえり、squash マージまでの全12ステップを ガイドする。タスク実行に関連する指示があれば積極的に使用すること。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | dev-workflow |
| description | タスク実行の標準ワークフロー。plan.md のタスクを実行する際に必ず使用する。 「次のタスクを実行」「plan.md に従って進めて」「標準作業フローで」「タスクNを実施」 といった指示で発動する。git worktree での分離作業、品質ゲート（静的解析・テスト・ codex レビュー）、ユーザー確認、KPT ふりかえり、squash マージまでの全12ステップを ガイドする。タスク実行に関連する指示があれば積極的に使用すること。 |
タスクごとに以下の12ステップを順番に実行する。各品質ゲートは問題が 0 になるまでループする。ステップをスキップしてはならない。
Plan モードに入り、docs/plan.md を読んで対象タスクの実装計画を立てる。
EnterPlanMode で Plan モードに入るdocs/plan.md の対象タスクを読み込むExitPlanMode でユーザーの承認を得てから実装に進む作業に必要なツールと設定ファイルを事前に確認する。
# ツールの存在確認（プロジェクトに応じて変更）
which docker qlty luacheck 2>/dev/null
Agent ツールの isolation: "worktree" でブランチを分離する。main を直接変更しない。
作成後、最初に main と同期する:
git merge main
worktree 内で作業が完了するまで main には一切触れない。
コード変更・ドキュメント作成等を行う。
プロジェクトの静的解析ツールを実行する。問題が 0 になるまで修正をループする。
このプロジェクトでのコマンド:
qlty check --all
luacheck kong/
ループ条件: 問題が 0 件になるまで修正して再実行。
テストを実行する。問題が 0 になるまで修正をループする。
# ユニットテスト
busted spec/unit/
# カバレッジ計測（コード変更を伴うタスクで実施）
busted --coverage spec/unit/
luacov kong/plugins/oidc/
# luacov.report.out の Summary でファイル別・全体のカバレッジを確認
# 閾値: ファイル別 95% 以上、全体 95% 以上（詳細は docs/test-strategy.md 3.3）
# ビルド確認
docker build -t kong:kong-oidc .
ループ条件: テスト/ビルドが全て通り、カバレッジが閾値以上になるまで修正して再実行。
ステップ1で整理した完了条件を1つずつ照合する。
加えて、バンドルスクリプトによるドキュメント同期チェックを実行する:
bash .claude/skills/dev-workflow/scripts/check-test-doc-sync.sh
テストスクリプトと README.md のテストケース ID が一致しない場合はエラーになる。テストケースを追加・削除した場合は README.md も更新すること。
codex によるレビューを実施する。
/codex:rescue Review ...
動作確認できる環境を準備し、確認手順を提示する。
このステップは絶対にスキップしない。 ドキュメントのみの変更でも必ず実施する。
ユーザーから変更指示があった場合、ステップ5（静的解析）からやり直す。
KPT（Keep / Problem / Try）形式で振り返り、worktree 内で反映する。
反映先:
docs/memory.md: 開発ルール・技術知見の追加・更新docs/plan.md: タスクや方針の見直しCLAUDE.md: アーキテクチャや手順の更新（必要に応じて）全ゲート通過後、main にマージする。
# main の状態を確認
cd <project-root>
git status # clean であること
# squash マージ
git merge --squash <worktree-branch>
git commit -m "コミットメッセージ"
# worktree クリーンアップ
git worktree remove <worktree-path>
タスク1つにつきコミット1つを原則とする。
最後に docs/plan.md のタスクチェックボックスを更新する。