開発はLinuxで、確認はWindows。こういう体制だと、手順書を「どうやって相手の画面に届けるか」で毎回つまずきます。

ママゴトラボでは2026年8月から、この手順書をClaude Codeのアーティファクト(Claude Codeが作ったHTMLページを、claude.ai上の非公開URLに公開する機能)で渡しています。

アーティファクトは11月15日までに計36枚作りました。このうち実機確認・操作手順は7枚で、残りは案の比較や顧客との共有などです(内訳は5章)。この記事は、その手順書の型と、運用して分かった制約の記録です。

結論から書きます。

以下、実物の型と制約を順に書きます。

前提(この記事の数字と事実の出どころ)

1. なぜmdの手順書をやめたか

以前は、実機確認の手順をMarkdown(md)ファイルで書き、開発機に置いていました。この運用で困ったのは次の3点です。

困りごと mdのとき アーティファクトにしてから
別のPCで開く ファイルをUSBやNASで運ぶ 同じclaude.aiアカウントでログインし、URLを開くだけ
どこまで進んだか 頭で覚える・紙に書く チェックボックスと進捗バー(ページに自分で組み込む)
コマンドを打つ 選択してコピー(はみ出しやすい) 「コピー」ボタン(同上)

チェックボックスやコピーボタンは、アーティファクトの標準機能ではありません。Claudeに頼んでHTMLとJavaScriptで組み込んだものです。アーティファクトが担うのは「そのページを、別の端末からURLで開ける場所に置く」部分です。

手順書の読み手は、たいてい別の端末の前にいる人です。開発機の中にあるファイルは、その人の手元にありません。ここが一番大きい理由でした。

なお、記事は今もmdのままです。記事は公開用の仕組みに流すため、HTMLにする理由がありません。使い分けは「人が画面の前で、順番に操作するか」で決めています。

2. 1手順=「打つもの・期待する表示・つまずいたら」

手順書を作るうちに、手順1つの中身はこの3点で固定しました。通信を測る試作ツールを、Windowsで動かして確かめたときの手順書から抜粋します(構造だけの抜粋で、コピーボタンの処理などは省いています)。

<li class="step">
  <input type="checkbox" id="s-test">
  <label for="s-test">テストを流す</label>
  <div class="body">
    <!-- 打つもの -->
    <div class="cmd"><pre>python -m unittest test_logic</pre><button type="button">コピー</button></div>
    <!-- 期待する表示 -->
    <div><div class="k">期待する表示(30秒ほど)</div>
      <pre class="out">Ran 59 tests in …s
OK</pre></div>
    <!-- つまずいたら -->
    <p class="tip"><b>つまずいたら</b> FAILやERRORが出たら、その画面をそのまま持ち帰ってください。</p>
  </div>
</li>

3点をそろえる理由はこうです。

手順の番号は実際に作業する順に振ります。準備・Python版で動かす・exeにして動かす、のように節を分け、番号は節をまたいで通しにしました。

3. チェックの状態は、Claudeに戻らない

ここが運用して一番大事だった点です。

私の手順書では、チェックボックスの状態を、ページの中のJavaScriptでブラウザのlocalStorage(ブラウザがサイトごとに持つ小さな保存場所)に入れています。

var KEY = 'netprobe-win-check';
try { state = JSON.parse(localStorage.getItem(KEY) || '{}') || {}; } catch (e) { state = {}; }
// …変更のたびに
try { localStorage.setItem(KEY, JSON.stringify(state)); } catch (e) {}

localStorageは、開いたブラウザの中にしかありません。WindowsのChromeで付けたチェックは、そのChromeにだけ残ります。この作りには、状態をClaude Codeへ送る仕組みがありません。開発機のClaudeからは見えませんし、別の端末で開けば白紙です。

なお公式には、組織内で共有したページにコメントを残し、Claudeに読ませる機能もあります(チーム向けプランの機能)。個人プランの私の運用では使っておらず、チェックの状態とも別物です。

try で囲んでいるのは、プライベートウィンドウなど、保存が使えない環境でもページ自体は動くようにするためです。

そこで、手順書の最後に必ずこの欄を置いています。

終わったら持ち帰るもの
・手順5(と6)の画面の表示(コピーして貼るだけで十分)
・つまずいた手順があれば、その画面
・余裕があれば ログファイルとレポートのHTML

確認した人は、この3つを開発機の会話に貼ります。Claudeはそれを見て直します。

公式ドキュメントにも、同じ考え方の使い方が「結果をセッションに戻す」として載っています。ページで操作した結果をテキストにして、ターミナルに貼り戻す形です。私の運用では、確認結果の正本は会話かファイルに残し、ページは操作の道具と割り切るのが合っていました。

4. 運用で分かった制約

公式ドキュメントに書かれている制約のうち、実際に効いたものを挙げます。

制約(公式) 運用での影響 やったこと
ページは自分ではダウンロードを始められない(通常のダウンロードリンクも不可) 手順書のページにzipを添えて配る作りにできない zipはUSBやNASで別に渡し、手順書にはその置き場所だけ書く
外部の画像は読み込めない。スクリプトは指定の5つのCDNのみ 画面写真を外部URLで貼れない 図はHTMLとCSSで描く。写真は使わない
フォントはGoogle Fontsのみ外部から読める 読みやすい日本語フォントを使いたい BIZ UDPゴシックをGoogle Fontsから読み、読めないときの代わりも指定
表示サイズは16MiBまで 画像を埋め込むと膨らむ 画像を入れない設計で、上限に当たったことはない

ダウンロードについては、公式に「ダウンロード機能」という別の仕組みがあり、アカウント単位で有効になると書かれています。ページが作ったCSVなどを保存させる用途です。私の運用では、手順書とツール本体を分けて渡す形で困っていないので、使っていません。

もう1つ、使えない条件も押さえておく必要があります(公式ドキュメントの「利用可能性」より)。

自動化の途中で手順書を作らせたいときは、-p では公開されない点に注意が要ります。

5. 手順書以外に広がった使い道

36枚を題名で分けると、こうなりました(題名から私が分類した数です)。

種類 枚数 中身
個人開発の案出し・選択 18 案を並べて、どれにするかを選んでもらう
実機確認・操作手順 7 この記事の本題。チェック付きの作業票
顧客との共有 4 作業計画の表(WBS)や提案
出品文の下書き 3 見た目ごと確認したい文面
その他 4 設定の見直し・コマンドの早見表など

意外だったのは、一番多いのが「選んでもらう」用途だったことです。案をA・B・Cと文章で並べる代わりに、絵と短い説明を並べたページにしています。ターミナルの文字だけでは比べにくい案ほど、ページのほうが選びやすくなります。

作業計画のように更新が続くものは、進むたびに同じURLへ公開し直します。開いている人は、その場で更新を見られます(公式の仕様)。

社外の人に見せるときは、公開範囲に注意が要ります。 公式ドキュメントでは、組織内の特定の人だけに見せる共有はTeam・Enterpriseプランの機能です。個人プランで社外の相手に渡すと、リンクを知っている人なら誰でも見られる公開リンクになります。顧客の情報を載せるページは、この前提で中身を決める必要があります。

6. 業務での線引き

最後に、どこまでをアーティファクトにするかの判断基準です。

私の環境では、手順書の課題は書き方より先に、読む人の手元に届く形になっていないことでした。URL1本で開けて、判断基準と持ち帰るものが書いてある。手順書に必要なのは、まずこの形です。

別のPCでの確認や引き継ぎで、説明の往復が増えていませんか。今の手順書と、困っている箇所をテキストで送っていただければ、組み直し方からご提案します。

👉 ご相談はこちら(クラウドワークス)

関連記事
- 引き継ぎ手順書が伝わらない原因と直し方──読む人が詰まる3つの言葉
- ブラウザ操作を記録して手順書を作るChrome拡張──CSVで同じ登録を一括入力する

ママゴトラボは、業務の自動化ツールを「何を作るか」を決めるところ(要件定義)から設計してつくる開発ラボです。
属人化した業務の見える化から、自動化ツールの開発・保守まで承っています。
👉 ママゴトラボ|業務自動化の開発ラボ

その業務、自動化できるかもしれません

「毎回手でやっている作業」を、「何を作るか」を決めるところ(要件定義)から見直してツールにします。GAS・Python・VBAでの自動化のご相談を承っています。

クラウドワークスで相談する →
ブログ一覧に戻る