01_ArticleOrganization

01 Articleorganization

ochtum b644c9d 2 files · 2.4 KB Updated

File contents

使うタイミング

ユーザーが「記事整理」「元ネタ整理」「この情報を記事化できるように整理して」などを依頼したときに使います。

入力

ユーザー入力には、技術情報の本文、メモ、URL、またはそれらの組み合わせが含まれます。 入力が空でない場合は、再入力を求めずにその内容を使ってください。

ワークスペース解決ルール

  • ユーザー入力の先頭に Workspace: C:\absolute\path の形式でワークスペースが指定されていれば、それを {Workspace} として使います。
  • 指定がない場合は、現在の作業ディレクトリを {Workspace} として扱います。

実行手順

  1. {Workspace}\.specify\memory\記事整理-constitution.md を読み込みます。
  2. {Workspace}\templates\記事整理-template.md を読み込みます。
  3. 入力された技術情報を、初心者にも伝えられるレベルまで分解して理解します。
  4. URLが含まれる場合は本文を取得し、記事化に必要な情報を抽出します。
  5. 説明に必要なソースコード、補足説明、画像がある場合は必ず元ネタに取り込みます。
    • 画像取得が必要な場合は {Workspace}\scripts\download-images.ps1 の利用を検討します。
    • 画像は事実関係、要素、関係性、処理順序を文章でも説明します。
    • 元ネタ画像は後工程の参考資料であり、記事への掲載、加工、図解生成への入力は禁止であることを明記します。
  6. 技術情報単位ごとに、テンプレートの形式に従って {Workspace}\元ネタ\ にMarkdownで出力します。

出力ルール

  • 出力先: {Workspace}\元ネタ\
  • 形式: Markdown
  • ファイル名は内容が分かる日本語名にします。
  • 推測で補完せず、不明点は「不明」または「要確認」として残します。
  • 元ネタ画像には出典と 参考のみ・掲載禁止 を付けます。
  • 既存ファイルを上書きする必要がある場合は、内容を確認してから最小限に更新します。

ochtum/TechBlogWriter/tree/main/.codex/skills/01_ArticleOrganization commit b644c9d198

Frequently asked questions

npx skillmds@latest add ochtum/01-articleorganization