Skip to content
cccskills
FreePublished on GitHub

plan-markdown-export

AIとの壁打ちで整理したプラン、または別ファイルの設計メモや実装メモを、読みやすいMarkdown形式の実装プランに整形して `docs/plan/YYYY-MM-DD_<plan-name>.md` に保存する作業で使う。

会話中に提案したプランの書き出し、テキストメモの構造化、見出し整理、表への変換、チェックリスト化、保存が必要なときに使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md3.1 KB
  • normalize-rules.md917 B
  • template.md678 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plan Markdown Export

AIとの壁打ちで整理したプラン、または既存のメモを、レビューしやすい Markdown の実装プランに整形して保存する。

想定する使い方

  • /plan-markdown-export 提案してくれたプランを出力して
  • /plan-markdown-export さっき整理した実装案を markdown にして
  • /plan-markdown-export /path/to/memo.txt をベースにプラン化して

入力の扱い

  • 引数にファイルパスや明示的な入力元が含まれる場合は、その内容を優先して使う
  • 引数に具体的な入力元が無い場合は、このセッション内で直近に提案・整理・合意したプラン内容を入力として使う
  • セッション内に十分なプラン内容が無い場合は、推測で埋めず、不足情報を確認する

原則

  • 元プランの意図・判断・前提・リスク・検証項目を落とさない
  • 断片的な議論を、レビュー可能な粒度の実装プランに再構成する
  • 表現だけ整え、要件や設計判断を勝手に追加しない(詳細は normalize-rules.md)
  • 必要に応じて GitHub Flavored Markdown の表、箇条書き、チェックリスト、コードブロックに変換する

手順

  1. 入力元を特定する
  2. 会話中のプラン、または指定メモから、タイトル・背景・方針・実装手順・リスク・検証項目を抽出する
  3. プラン名を決める。タイトルから短い ASCII の kebab-case を作る(指定がある場合はそれを使う)
    • 例: "WezTerm CLI の操作性改善" → wezterm-cli-comfort
  4. docs/plan/ が無ければ作成する
  5. 生成先パス docs/plan/YYYY-MM-DD_<plan-name>.md を決める(日付はローカル日付)。既存ファイルがあれば上書き前に確認する
  6. template.md をベースに Markdown を出力する
  7. 生成ファイルのパスを返す

正規化ルール

normalize-rules.md を参照。

テンプレート

出力形式は template.md を参照。

  • 入力に Current structure や Design policy が無い場合は、該当セクションを省略してよい
  • File changes と Risks and mitigations は、情報が表形式に向いている場合は表を優先する
  • 会話ベースのプラン出力では、文脈上明らかな内容だけを補完してよいが、未合意事項は Open questions に残す

注意

  • 入力元が曖昧な場合は、どのプランを出力するか確認する

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Convert Claude markdown subagent files to Codex CLI TOML format. Parses YAML frontmatter and body, applies model/permission/tool mappings, and outputs to agents/codex/<name>.toml.

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

Create or update a Markdown blog draft from recent work and export it with `YYYY-MM-DD_slug.md` naming. Output directory can be set via environment variable or CLI option; if missing, ask the user and pass it explicitly.

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

変更をコミットしてドラフトPRを作成する一連のGit/ghワークフロー。ユーザーが「コミットして」「PR作って」「draft PR」等を求めたときに使用し、status/diff確認・命令形コミット・push・gh pr create --draft(--assignee hodanov)まで実行する。ユーザーの明示リクエストが無くても、実装完了後にcommitやPRが必要になった場面(dev-workflowのcommitフェーズ等)では必ずこれを使う。`git commit` や `gh pr create` を単体でBash直接実行しない。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

1 つの作業ツリーに混ざった差分を、変更理由ごとの意味単位のコミットへ分割する。ユーザーが「コミットを分割して」「意味単位で分けて」「commit-split」等を求めたとき、または機能追加・付随リファクタ・設定/ドキュメント修正が 1 コミットに混在していると気づいたときに使用する。分割案を提示して承認を得てからステージし、コミットごとに単独で成立することを確認する。メッセージ規約・push・PR の作成は commit-and-draft-pr へ委譲する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

gitleaks + pre-commit を使ってローカルコミット時のクレデンシャル混入を機械的にブロックする。「クレデンシャル漏洩防止」「シークレット混入対策」「gitleaks」「pre-commit シークレット」「credential leak prevention」に言及した場合に使用する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

依存パッケージ(Go modules / npm / Terraform provider / GitHub Actions / pre-commit 等)の アップグレードを、outdated 検出 → CHANGELOG・破壊的変更の確認 → 更新 → lint/test 検証 → コミットまで一連の手順で安全に適用する。「依存更新」「パッケージを上げて」「dependency update」 「go get -u」「npm update」「provider を上げる」等に言及されたときに使用する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

See all skills by hodanov

Report a problem with this skill