hirokimry/docs-rewrite-all
skills/docs-rewrite-all/SKILL.md
`docs/**/*.md` + `README.md` + `CHANGELOG.md` を一括棚卸しし、 `.claude/rules/document-writing.md` と機械的に照合する。 領域別に C*O へ書き換えを委譲し、diff 提案 → CEO 承認 → 書換の 2 段階で自動マージを禁じる。`LICENSE` は除外する。 「/vibecorp:docs-rewrite-all」「ドキュメント全書き直し」「ドキュメント棚卸し」 と言った時に使用。
$ install --global
skillsauthnpx skillsauth add hirokimry/vibecorp docs-rewrite-allInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 2:50 AM172.4s2 files scanned
SKILL.md
- name:
- docs-rewrite-all
- description:
- >
- 「/vibecorp:
- docs-rewrite-all」「ドキュメント全書き直し」「ドキュメント棚卸し」
📖 docs-rewrite-all: ドキュメント全書き直しスキル
[!IMPORTANT] このスキルは diff 提案 → CEO 承認 → 書換の 2 段階を必須化 する。 自動マージは禁止する。 機械的書き直しで意味を壊さないための設計判断。
リポジトリ内のドキュメントを ドキュメント作成基準 に沿って一括で書き直し提案する。 書き換えそのものは行わず、必ず CEO 承認を経由する。
🎯 対象範囲
| 観点 | 内容 |
|------|------|
| 📂 対象パス | docs/**/*.md + README.md + CHANGELOG.md |
| 🚫 除外 | LICENSE（法的文書、書き換え対象外） |
| 📐 適用基準（本文） | .claude/rules/document-writing.md（ドキュメント本文の書き方基準） |
| 💬 適用基準（md 内コメント例） | .claude/rules/comment-writing.md（Issue/PR/レビュー/Bot 通知のコメント例を含む md の照合基準） |
| 🤝 委譲先 | 領域に応じた C*O Agent |
| 🔐 承認 | CEO 承認なしに書き換えない（2 段階必須） |
🧭 7 段階動線
このスキルは以下 7 段階を順に進める。
| ステップ | 名称 | 役割 | |---------|------|------| | 1️⃣ | 列挙 | 対象ファイルを収集する | | 2️⃣ | 照合 | 基準と機械的に突き合わせる | | 3️⃣ | 委譲 | 領域別に C*O Agent を呼び出す | | 4️⃣ | 提案 | diff を CEO に提示する | | 5️⃣ | 承認 | CEO の判断を待つ | | 6️⃣ | 書換 | 承認分のみファイルに反映する | | 7️⃣ | レポート | 結果を CEO 向けに整形する |
各ステップは前段の出力を受け取り次段へ渡す。
ステップ 5（承認）でスキップが指示された項目は、ステップ 6 で書き換えない。
1️⃣ 列挙: 対象ファイル収集
対象ファイルを以下の手順で収集する。
find docs -type f -name '*.md' -print
ls README.md CHANGELOG.md
LICENSEは除外する（法的文書）。docs/migration/配下のような履歴アーカイブも対象に含める。- 履歴であっても読者がスキャンする可能性があるため。
- ファイル一覧を変数に保持し、ステップ 2 へ渡す。
2️⃣ 照合: 基準との機械的突き合わせ
ステップ 1 のファイル一覧を、以下 2 基準の 指針 MUST 全項目 と 禁止パターン全項目 に対して 1 件ずつ突き合わせる。
| 基準 | 照合対象 |
|------|---------|
| .claude/rules/document-writing.md | ドキュメント本文（章立て・動作主語・スキャン性等） |
| .claude/rules/comment-writing.md | md 内に登場する GitHub コメント例（Issue/PR テンプレ例・レビュー例・Bot 通知例） |
照合対象の項目本体は各基準ルールが Single Source of Truth。
- 指針 / 禁止の項目本体は基準ルールに閉じる（スキル側で項目を重複列挙しない）。
- 各ファイルに対し「該当する基準項目（指針 N / 禁止 N）」と「該当行番号」を表で記録する。
- ドキュメント本文と md 内コメント例の両方を持つファイルは両基準で照合する。
- 検出結果が空のファイルはステップ 3 以降の対象から外す。
3️⃣ 委譲: 領域別 C*O Agent 呼び出し
各ファイルの 内容領域 に応じて、書き換え提案を担当する C*O を選ぶ。
領域 → C*O 対応表
| 領域 | 対象ドキュメント例 | 委譲先 |
|------|------------------|--------|
| 🔒 セキュリティ | docs/SECURITY.md / セキュリティ仕様 | CISO |
| 💰 コスト | docs/cost-analysis.md / 課金構造 | CFO |
| 🛠️ 技術 | docs/specification.md / 設計判断 / アーキテクチャ | CTO |
| ⚖️ 法務 | docs/POLICY.md / LICENSE 周辺 / 規約 | CLO |
| 📦 プロダクト | README.md / docs/ai-organization.md / MVV 周辺 | CPO |
| 🔄 変更履歴 | CHANGELOG.md | CTO（リリース管理担当） |
領域が複数にまたがる場合は、主たる領域の C*O に委譲する。
判定に迷う場合は CPO に委譲する（プロダクト全体の窓口として）。
委譲方法
Agent ツールで該当 C*O を起動する。プロンプトは skills/docs-rewrite-all/prompts/agent-call-cxo-rewrite.md を参照する。
CO は複数並列で起動してよい（各 CO は別ファイルを扱うため競合しない）。
4️⃣ 提案: diff を CEO に提示
ステップ 3 で集めた書き換え案を、ファイル単位の diff として整形する。
提示時は以下を明示する。
- ✅ 適用候補: 基準逸脱を解消する書き換え。
- ⚠️ 要判断: 意味解釈の余地がある書き換え。
- 📍 根拠: 該当する指針 / 禁止項目の番号。
提示は ファイル単位 にまとめる。
- 全ファイルを一括提示すると CEO のレビュー負荷が高くなる。
- 1 ファイルずつ承認を取る運用を基本とする。
- CEO の指示で「まとめて見る」と言われた場合のみ複数ファイル同時提示に切り替える。
5️⃣ 承認: CEO 判断を待つ
CEO に以下の選択肢を提示する。
| 選択肢 | 効果 | |--------|------| | ✅ 全採用 | 提示した diff を全て書き換え対象に取る | | 🔢 項目選択 | 採用したい項目の番号を指定する | | ⏭️ スキップ | このファイルの書き換えを保留する | | ✋ 中止 | スキル全体を中止する |
承認なしに書き換えは行わない。
AskUserQuestion ツールで選択肢を明示提示してもよい（CEO の判断負荷を下げるため）。
6️⃣ 書換: 承認分のみファイル反映
ステップ 5 で承認された項目のみを Edit ツールで反映する。
書き換え後は以下を必ず実行する。
- 既存テスト一式を走らせる（ドキュメント参照を持つテストの破壊検出）。
- 該当する rule のテスト（
tests/test_*_rule.sh）を走らせる。 - 破壊が出た場合はその場で書き換えをロールバックし、CEO に報告する。
書き換えは ファイル単位の commit で行う（後追いで diff を追跡できるように）。
7️⃣ レポート: CEO 向け結果整形
以下のフォーマットで結果を CEO に返す。
## 📖 docs-rewrite-all 完了レポート
### 📊 集計
- 対象ファイル数: N 件
- 書き換え採用: M 件
- スキップ: S 件
- 中止: 0 / 1
### ✅ 採用された書き換え
- {ファイル名}: {変更の動作主語要約}（採用 K 件）
### ⏭️ スキップされた項目
- {ファイル名}: {スキップ理由}
### ⚠️ CEO 判断保留
- {ファイル名}: {判断保留の論点}
### 📍 次のアクション
- 必要に応じて `/commit` で書き換えをコミット
- 残課題は別 Issue で起票（`/issue`）
レポートは 動作主語（〜になった / 〜できるようになった）で書く（communication.md 規約）。
🤝 委譲先エージェント
このスキルは以下の C*O Agent を呼び出す。
| エージェント | 専門領域 |
|-------------|---------|
| cto | 技術・アーキテクチャ・リリース管理 |
| cpo | プロダクト方針・README・MVV |
| cfo | コスト・課金構造 |
| ciso | セキュリティ |
| clo | 法務・ライセンス・規約 |
各 C*O は 管轄ファイルのみ 書き換え提案する。
🛡️ 制約
- 自動マージ禁止: CEO 承認なしに書き換えない（2 段階必須）。
- 意味改変禁止: 基準適合の整形のみ、意味を変えない。
- LICENSE 除外: 法的文書は本スキルの対象外。
- 既存テスト破壊禁止: 書き換え後にテストを走らせ、破壊があればロールバック。
- shell 規約: スクリプト記述は
.claude/rules/shell.mdを遵守する。 - autonomous-restrictions 準拠: 本スキルは自律改善ループ（
/vibecorp:diagnose→/vibecorp:autopilot→/vibecorp:ship-parallel）の自動実行対象外とし、人間（CEO）の明示承認を必須化する（.claude/rules/autonomous-restrictions.md）。
🔗 関連
- 適用基準（本文）:
.claude/rules/document-writing.md - 適用基準（md 内コメント例）:
.claude/rules/comment-writing.md - 動作主語ルール:
.claude/rules/communication.md - マークダウン規約:
.claude/rules/markdown.md - shell 規約:
.claude/rules/shell.md - 配置・言語ルール:
.claude/rules/documentation.md - 自律実行不可領域（人間承認必須）:
.claude/rules/autonomous-restrictions.md - 類似多段動線スキル:
skills/sync-check/SKILL.md/skills/sync-edit/SKILL.md - 関連スキル:
/vibecorp:prompts-rewrite-all（プロンプト系.mdを扱う） //vibecorp:comments-rewrite-all（コード内コメントを扱う）
Related Skills
hirokimry/prompts-extract-all
data-ai
VerifiedTrustedCommunity
skills/**/SKILL.md 内に embed された 5 行以上のエージェント呼出プロンプトテンプレ・長文ブロックを .claude/rules/notification-prompt-extraction.md 基準で skills/<skill>/prompts/<name>.md に切り出す migration skill。「/prompts-extract-all」「プロンプト切り出し」「プロンプト extract」「SKILL.md プロンプト migration」と言った時に使用。検出は awk でフェンスコードブロックを抽出して行数カウント、要否判定は LLM が閾値・用途軸・命名規約と照合。diff 提案 → CEO 承認 → 書換の 2 段階で挙動を壊さず適用する。自動マージ禁止、自律ループ対象外。
1SKILL.mdUpdated May 19, 2026
hirokimry/notifications-extract-all
documentation
VerifiedTrustedCommunity
.github/workflows/**/*.{yml,yaml} の --body 通知文と hooks/**/*.sh の長文 echo/printf/heredoc を .claude/rules/notification-prompt-extraction.md 基準で個別 .md ファイルに切り出す migration skill。「/notifications-extract-all」「通知文切り出し」「通知文 extract」「workflow 通知 migration」と言った時に使用。検出は grep で機械絞り込み、要否判定は LLM が閾値・命名規約と照合。diff 提案 → CEO 承認 → 書換の 2 段階で挙動を壊さず適用する。自動マージ禁止、自律ループ対象外。
1SKILL.mdUpdated May 19, 2026
hirokimry/comments-rewrite-all
development
VerifiedTrustedCommunity
`**/*.sh` / `**/*.js` / `**/*.ts` / `**/*.py` / `**/*.rb` / `**/*.go` / 設定ファイル等のコード内コメントを一括棚卸しし、 `.claude/rules/code-comments.md` と機械的に照合する。 diff 提案 → CEO 承認 → 書換の 2 段階で自動マージを禁じる。 生成コード・`node_modules`・`vendor`・`dist`・`build` 等は除外する。 「/vibecorp:comments-rewrite-all」「コメント全書き直し」「コード内コメント棚卸し」 と言った時に使用。
1SKILL.mdUpdated May 19, 2026
hirokimry/prompts-rewrite-all
development
VerifiedTrustedCommunity
skills/**/SKILL.md・agents/*.md・.claude/rules/*.md を .claude/rules/prompt-writing.md 基準で一括書き直し提案するスキル。「/prompts-rewrite-all」「プロンプト書き直し」「スキル一括書き直し」「エージェント書き直し」と言った時に使用。claude-code-guide サブエージェントで Claude Code 公式仕様（docs.claude.com）を確認し、prompt-writing.md の指針 MUST / 禁止パターンと照合する。diff 提案 → CEO 承認 → 書き換えの 2 段階で挙動を壊さず適用する。自動マージ禁止。
1SKILL.mdUpdated May 18, 2026