بنقرة واحدة
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)