write-workflow について
write-workflowは、技術レビューまたは文章のヒューマナイズに処理を振り分ける段階的な文書作成スキルです。情報分析、モード管理、検証、振り返りを担い、開始時に依存スキルを確認します。
主な機能
- 018段階の文書作成ワークフロー
- 02レビューとヒューマナイズへの振り分け
- 03手動・自動モード
- 04完全・段階的・簡易パス
- 05依存関係の確認と出力検証
活用シーン
- 01設計資料から技術レビューを作成
- 02英語または中国語の文章をヒューマナイズ
- 03文書変更に適した作成パスの選択
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/write-workflowを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
ワークフローの作成
8 段階のドキュメント作成ホストです。ライターのスキルが方法論を担い、このホストはルーティング、ソース分析、モードのライフサイクル、パスの深さ、検証と振り返りを担います。
ライター：
tech-review-doc（リポジトリ内、設計 → レビュー）。humanizer/humanizer-zhは英語／中国語の不自然な表現を取り除くための外部の強力な依存関係です（このリポジトリには同梱されていません）。
solve-workflow/analysis-coreではありません。ステージ 2 は、文章作成に特化したソース分析のみを行います。出力テンプレート： reference.md。
前提スキルの確認
起動時に、frontmatter の dependencies に記載されたすべての項目を確認してください。欠けている項目がある場合は、インストール方法を案内して中止してください。黙って機能を低下させてはいけません。
| 不足しているスキル | インストール方法（ディレクトリ名／name は一致させる必要があります） |
|---|---|
clarifying-question-discipline、tech-review-doc、workflow-mode-lifecycle | npx skills add FuDesign2008/open-skills -g --skill <name> --yes |
humanizer | npx skills add https://github.com/blader/humanizer.git → スキルディレクトリ humanizer |
humanizer-zh | npx skills add https://github.com/op7418/Humanizer-zh.git → スキルディレクトリ humanizer-zh |
または、すべてのリポジトリ内の open-skills をインストールします：npx skills add FuDesign2008/open-skills -g --skill '*' --yes（外部の humanizer はインストールされません）。
依存してはいけないもの： analysis-core、runtime-evidence-debug、hybrid-debug、browser-debug-toolkit。
リポジトリに含めてはいけないもの： このリポジトリに skills/humanizer/ や skills/humanizer-zh/ を追加しないでください。
トリガーとモード
| 表現 | モード | 備考 |
|---|---|---|
| 「写文档」「写文档工作流」「write workflow」 | 👤 手動 | ドキュメントの種類を判定 |
| 「写技术评审」「生成评审文档」 | 👤 手動 | tech-review-doc にルーティング |
| 「去AI痕迹」「人性化改写」「humanize」 | 👤 手動 | 言語に応じて humanizer / humanizer-zh にルーティング |
| 「自动写文档」「自动模式」+ 作成の意図 | 🤖 自動 | 次に進む。ただしライター固有の強制停止は適用 |
モードの判定： 「自动」なら自動、それ以外は手動です。実行中は「切换自动模式」／「切换手动模式」で切り替えます。
基本のライフサイクル → workflow-mode-lifecycle。相違点：
- 完了 = ステージ 8 が終了 → 手動に戻します。
- 強制停止（自動モードでも適用）：
tech-review-doc：§1 でユーザーの承認が必要。設計パスがない場合humanizer/humanizer-zh：入力テキストまたはファイルパスの確認が必要（tech-review §1 の承認ゲートは適用されません）
- 自動モードで強制停止が解除された後は、追加のホスト停止なしでライターを続行し、ステージ 7～8 に進みます。
- 中断された場合 → 手動に戻します。
パスの選択
| パス | 対象 | 深さ |
|---|---|---|
| フル | 大規模なレビュー／曖昧な目標／大幅な人間らしさの調整 | ライターの全工程 |
| インクリメンタル | 一般的なドキュメント | デフォルト |
| リーン | 小規模で確実性の高い変更 | オプションのセクションを最小限にします。検証とライターの強制停止は省略しません |
⚡ クイックリファレンス
| ステージ | 👤 手動での停止 | 🤖 自動 | 必須の出力 |
|---|---|---|---|
| 1 意図の明確化 | ⛔ ルート／パス／モードを確認 | 明確なら省略 | 意図の言い換え + ライター + パス |
| 2 ソースの分析 | ⛔ 不足点／準備状況 | ブロッカーがなければ続行 | 資料一覧 + 不足点 |
| 3 アプローチの検討 | ⛔ 選択肢 | 自動選択 | アプローチ |
| 4 アプローチのレビュー | ⛔ チェックリストの確認 | 問題がなければ自動承認 | チェックリスト |
| 5 概要の作成 | ⛔ 確認 | 引き継ぎ | 概要／人間らしさ調整の計画 |
| 6 ライターの実行 | ライターの強制停止 | 同じ停止。解除後は連続して実行 | ライターの出力 |
| 7 検証 | ⛔ 確認 | 問題がなければ続行 | 検証レポート |
| 8 振り返り | 終了 | 終了して手動に戻す | 改善点の要約 |
ステージ 1：意図を明確にする
- ドキュメントの種類／ライターのルート（下表）。
- パス（Full／Incremental／Lean）とモード。
- 不明確な場合は
clarifying-question-discipline（1ターンにつき質問は1つ）。 - **人間らしい文章にする言語：**主に中国語 →
humanizer-zh、主に英語 →humanizer、判断が難しい場合 → 1回だけ質問します。
| ドキュメントの種類 | ライター | ステータス |
|---|---|---|
| 技術レビュー（設計 → プロダクト／QA） | tech-review-doc | リポジトリ内 |
| AI っぽさの除去／人間らしい文章への書き換え（英語が中心） | humanizer | 外部依存（強） |
| AI っぽさの除去／人間らしい文章への書き換え（中国語が中心） | humanizer-zh | 外部依存（強） |
| その他 | 質問するか停止 | — |
[👤] 確認します。 [🤖] ルートと入力がすでに明確な場合は確認を省略します。
出力：reference.md § Stage 1。
ステージ 2：ソースを分析する
- **存在確認：**必須の入力が読み取り可能であること（設計パス、または人間らしい文章に書き換えるテキスト／ファイル）。
- **項目の洗い出し：**技術レビューの場合はタイトル／モジュール／Mermaid／複数の選択肢、人間らしい文章への書き換えの場合は言語、長さ、目標とするトーン。
- **不足情報：**後続ステージの妨げとなる要素を列挙します。
- まだ最終出力ファイルを作成しないでください（チャット内の分析メモを除く）。
[👤] レポートの後で停止します。 [🤖] 妨げとなる不足情報がない限り続行します。
ライタープロファイル別のステージ 3～5
プロファイル：tech-review-doc
- 3 図表／§3／§6／§4 の詳細度
- 4 対象読者向けチェックリスト（§§1～3 にコードを含めない）
- 5 概要 → ライターのステップ 1（§1 のドラフト）に引き継ぐ
プロファイル：humanizer／humanizer-zh
- 3 範囲：ドキュメント全体か選択部分か、トーン（フォーマル／カジュアル／技術的）
- 4 チェックリスト：事実を維持する、主張を捏造しない、トーンを合わせる
- 5 簡単な計画：入力 → 書き換え → 変更点の要約（任意）
[👤]/[🤖] クイックリファレンスに従って一時停止します。
ステージ 6：ライターを使って実行する
割り当てられたライターを読み込み、その指示に厳密に従ってください。
tech-review-doc：§1 で厳格なゲートを適用します。承認後は自動モードで連続実行できます。humanizer／humanizer-zh：入力の確認が必要です。その後、該当するスキルに従って書き換えます。技術レビューの§1は適用しないでください。
ステージ 7：検証する
- **
tech-review-doc：**パス／命名、§1 の承認、図表、§3／§6 のルール、§§1～3 の言語ルール。 - **
humanizer*：**事実が維持されていること、AI によくあるパターンが減っていること、トーンが一致していること。ライターが定義している場合は、品質スコアを付けてもかまいません。
出力：reference.md § Stage 7。
ステージ 8：振り返る
改善点を簡潔にまとめます。依頼がない限り、スキルファイルは編集しないでください。自動モードから手動モードに戻します。
拡張スロット（将来のライター向け）
skills/<name>/を追加して公開します。- プロダクトで強い依存が必要な場合を除き、任意のルートを優先します（外部の人間らしい文章への書き換えツールは意図的に強い依存としていますが、ここには同梱しません）。
- ルートの行と説明のトリガー（≤1024）を追加します。
- ステージ 6 は「ライターを読み込み、その指示に厳密に従う」のままにします。
他のスキルとの関係
| スキル | 関係 |
|---|---|
tech-review-doc | 強い依存（リポジトリ内）；レビューライター |
humanizer | 強い依存（外部）；英語の人間らしい文章への書き換え |
humanizer-zh | 強い依存（外部）；中国語の人間らしい文章への書き換え |
clarifying-question-discipline | 強い依存 |
workflow-mode-lifecycle | 強い依存 |
solve-workflow | 関連スキル — 接続されていません |
注意すべき兆候
- 自動モードで
tech-review-docの §1 を省略する - humanizer のルートに §1 のゲートを適用する
- humanizer スキルがない場合に、何も通知せず機能を低下させる
- このホストで
analysis-coreを宣言する - ライターの本文全体をこのファイルに直接埋め込む