원클릭으로
orchestrating-development
開発フェーズ全体の TDD ワークフローをオーケストレーション。記事執筆と TDD 実装を章ごとに同期しながら進める。開発フェーズの開始や開発手法の確認時に使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
開発フェーズ全体の TDD ワークフローをオーケストレーション。記事執筆と TDD 実装を章ごとに同期しながら進める。開発フェーズの開始や開発手法の確認時に使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | orchestrating-development |
| description | 開発フェーズ全体の TDD ワークフローをオーケストレーション。記事執筆と TDD 実装を章ごとに同期しながら進める。開発フェーズの開始や開発手法の確認時に使用。 |
記事執筆と TDD 実装を同期しながら進める開発フェーズ全体の作業を支援します。
--codex : Claude(計画・設計・受入)と Codex(実装)の分業体制で開発--chapter <言語> <章番号> : 指定した言語・章の執筆と実装を開始--sync : 執筆内容と実装コードの同期確認# 開発フェーズ全体のワークフロー表示
# 「開発フェーズの全体的な進め方を説明して」
# Java の第 1 章を執筆・実装
# --chapter java 1
# 「Java の第 1 章 TODO リストと最初のテストを開始」
# Claude と Codex の分業体制で開発
# --codex
# 「Java の実装を Codex に委託して進める」
# 執筆と実装の同期確認
# --sync
# 「記事内のコード例と apps/ の実装が一致しているか確認」
本プロジェクトの開発は「記事執筆」と「TDD 実装」を章ごとに同期しながら進めます:
graph TD
A[章の選択] --> B[参照記事の確認]
B --> C[執筆]
C --> D[TDD 実装]
D --> E[同期確認]
E --> F{不整合?}
F -->|あり| C
F -->|なし| G[MkDocs 更新]
G --> H{次の章?}
H -->|あり| A
H -->|なし| I[言語完了]
構成要素:
docs/article/{lang}/ に章ごとの Markdown を作成apps/{lang}/ で TDD サイクル(Red-Green-Refactor)を実行apps/{lang}/ の実コードの整合性を確認@docs/article/workflow.md のワークフローに従い、以下のサイクルを繰り返します:
Wiki 記事から該当内容を読み込みます:
| 部 | 参照先(Wiki) |
|---|---|
| 第 1 部: TDD の基本サイクル | tmp/k2works-wiki/記事/開発/テスト駆動開発から始めるXX入門/ エピソード 1 |
| 第 2 部: 開発環境と自動化 | 同上 エピソード 2 |
| 第 3 部: オブジェクト指向設計 | 同上 エピソード 3 |
| 第 4 部: 関数型プログラミングへの展開 | 同上 エピソード 4(該当言語のみ) |
docs/article/{lang}/NN-chapter-name.md にマークダウンで記事を作成します。
執筆フォーマット:
# 第N章: 章タイトル
## N.1 セクションタイトル
本文...
### コード例
\```java
// テストコード
@Test
void テスト名() {
// Arrange
// Act
// Assert
}
\```
### 実装
<details>
<summary>実装コード</summary>
\```java
public class FizzBuzz {
// ...
}
\```
</details>
Nix 環境で apps/{lang}/ にて TDD サイクルを実行します:
# 1. Nix 環境に入る
nix develop .#{lang}
# 2. apps/{lang}/ に移動(初回はプロジェクト初期化)
cd apps/{lang}
# 3. TDD サイクル
# Red → Green → Refactor
apps/{lang}/ の実コードと一致しているか確認mkdocs.yml の nav に章を追加docs/article/{lang}/index.md のリンクを有効化npm run docs:serve でローカルプレビュー確認各言語の開発環境は Nix で管理します:
| 環境名 | 言語 | Nix コマンド |
|---|---|---|
| java | Java | nix develop .#java |
| node | JavaScript / TypeScript | nix develop .#node |
| python | Python | nix develop .#python |
| ruby | Ruby | nix develop .#ruby |
| php | PHP | nix develop .#php |
| go | Go | nix develop .#go |
| rust | Rust | nix develop .#rust |
| dotnet | C# / F# | nix develop .#dotnet |
| clojure | Clojure | nix develop .#clojure |
| scala | Scala | nix develop .#scala |
| elixir | Elixir | nix develop .#elixir |
| haskell | Haskell | nix develop .#haskell |
記事: docs/article/{lang}/NN-chapter-name.md
実装: apps/{lang}/(言語固有のプロジェクト構成)
docs/article/{lang}/NN-chapter-name.md ←→ apps/{lang}/
(記事・解説) (実装コード)
記事内のコード例は apps/{lang}/ の実際のコードと一致させます。実装を先に TDD で進め、動作確認済みのコードを記事に転記します。
Red-Green-Refactor サイクルを厳密に実行:
--codex オプションを指定すると、Claude と Codex の分業体制で開発を進めます。
前提条件:
役割分担:
| フェーズ | 担当 | 責務 |
|---|---|---|
| 計画 | Claude | 章の選択、参照記事の確認、タスク分解 |
| 執筆 | Claude | 記事の構成・執筆、コード例の作成 |
| 実装 | Codex | apps/{lang}/ での TDD 実装 |
| 受入 | Claude | 同期確認、MkDocs 更新、品質チェック |
開発フロー:
graph LR
A[章の計画] --> B[記事執筆]
B --> C[実装指示]
C --> D[同期・受入]
subgraph Claude
A
B
D
end
subgraph Codex
C
end
Codex への指示例:
mcp__codex__codex
prompt: |
apps/java/ で FizzBuzz の TDD 実装を行ってください。
## 開発ガイド
docs/reference/コーディングとテストガイド.md に従って実装すること。
TDD サイクル(Red-Green-Refactor)を厳守すること。
## タスク
1. FizzBuzz クラスのユニットテストを作成
2. テストを通す最小限の実装
3. リファクタリング
## 完了条件
- 全テストがパス
- 静的解析エラーなし
- TDD サイクルに従って実装
sandbox: danger-full-access
approval-policy: never
cwd: プロジェクトルート
Codex MCP ツールのパラメータ:
| パラメータ | 説明 | 推奨値 |
|---|---|---|
prompt | 実装指示(詳細な要件を含む) | タスク単位で明確に記述 |
sandbox | 実行環境の権限レベル | danger-full-access(推奨) |
approval-policy | コマンド実行時の承認ポリシー | never |
cwd | 作業ディレクトリ | プロジェクトルート |
指示サイズに関する注意:
| 粒度 | 推奨度 | 説明 |
|---|---|---|
| 章単位(1 章分の実装) | 推奨 | 1 つの章に対応する TDD 実装 |
| 部単位(3 章分の実装) | 注意 | 進捗確認を頻繁に行う |
| 言語全体(12 章分) | 非推奨 | 章ごとに分割して実行 |
Codex が書き込みできない場合の対処:
apps/{lang}/ にプロジェクトが作成されているapps/{lang}/ の実コードと同期しているmkdocs.yml の nav に章が追加されているindex.md のリンクが正しい長時間の開発セッションでは Context limit reached エラーを回避するため、タスクの区切りごとに /compact を実施してコンテキストを圧縮する。
/compact を実施するタイミング:
運用ルール:
/compact 実施前に、現在の作業状態と次のタスクをメモとして出力する/compact 実施後、次のタスクの作業を継続する/compact を検討するops/nix/environments/ に言語環境が定義されていることapps/{lang}/ で TDD 実装を完成させるdeveloping-backend : バックエンド開発ガイド(TDD インサイドアウト)developing-frontend : フロントエンド開発ガイド(TDD アウトサイドイン)developing-release : リリースワークフロー(品質ゲート・バージョン管理・CHANGELOG)managing-docs : ドキュメント管理(MkDocs 更新・Lint)