skills/note-draft/references/note-editor-workflow.md

# noteエディター操作

## 操作の原則

- 現在の会話で操作可能なブラウザを使う。クラウドブラウザはローカルブラウザとは別セッションとして扱い、未ログインなら承認後にplatformのログイン画面で利用者自身の手動ログインを待つ。
- 現在の画面で見えるラベル、役割、状態を確認して操作する。
- 古いCSS selectorや固定座標へ依存しない。
- 読み取りと書き込みを分け、最初の書き込み前に完成物へ紐づく一度の承認があることを確認する。`note-studio`から承認が引き継がれている場合は再確認しない。
- noteは入力中に自動保存するため、文字入力を外部書き込みとして扱う。
- OGP等の見た目より、承認済みの本文、URL、画像、保存状態が失われないことを優先する。

## ログイン状態を判定する

noteを開いた直後の画面取得だけで、未ログインと確定しない。初期描画や認証状態の反映が終わる前は、プロフィール等の要素が一時的に取得できないことがある。主要な画面要素の描画を待ち、初回で判断できなければ短い待機後に最低一度は画面状態を再取得する。

プロフィールメニュー、通知、メッセージ、`新規投稿`への導線等、現在のUIでアカウント利用中と判断できる要素を組み合わせて確認する。これらが確認できれば、ログイン済みとして新規記事へ進む。

手動ログインを依頼するのは、再確認後もログイン画面へ移動している、または`ログイン`、`会員登録`等の明示的な未ログイン状態が表示され、認証済み要素がない場合だけとする。認証済み要素が一度取得できなかったことは、未ログインの根拠にしない。状態がまだ曖昧なら未ログインと断定せず、現在の画面をもう一度確認する。

## 新規記事

noteのトップまたは作成メニューから新規のテキスト記事を選ぶ。URLを直接開く場合も、新規作成画面であることを画面上で確認する。既存記事のタイトルや本文が表示されていたら入力を開始しない。

未ログインのため利用者へ手動ログインを依頼した場合、ログイン完了は承認内容の変更ではない。title、本文、タグ、画像、URL、対象下書きが変わっていなければ、ログイン後に同じ承認を求めず新規記事作成へ進む。

## 本文と見出し

原稿中の見出し識別子を記事へ貼らない。見出し名だけを独立した段落として入力し、段落全体を選択して、現在表示される書式メニューから大見出しまたは小見出しを選ぶ。

書式適用後、次の段落まで見出しになっていないか確認する。範囲選択が不安定な場合は、一見出しずつ処理する。目次、区切り線、中央寄せ、引用、太字は自動追加しない。

## 本文末尾のタグ

`note-studio`から受け取った本文には、最終段落から一行空けて、`#`付きnoteタグ5個または6個が半角空白区切りの一行で含まれている。この行を追加生成、分離、並べ替え、言い換えせず、本文の一部としてそのまま入力する。

タグ行が欠けている、個数が違う、`#`がない、半角空白区切りでない場合は入力を開始せず、文章一式の修正へ戻す。タグを本文末尾へ置いたまま下書き保存する。タグ登録を確認する目的で`公開に進む`や公開設定画面を開かない。本文末尾からタグを削除しない。

## URLとOGP

完成本文に独立したURL行がある場合は、URL末尾へカーソルを置いて改行する。OGPカードが表示された場合は、表示先が正しいURLに対応するか確認する。

追加URLは、利用者がURLと挿入位置を明示した場合だけ扱う。指定位置へ空の段落を作り、現在表示される追加メニューから`埋め込み`または同等の項目を選び、URLを貼り付けて適用する。

OGPカードが出なくても、正しいURLが本文に残り、リンクとして機能していれば続行する。URLの文字列、リンク先、ブラウザ上のリンク役割等、確認できる根拠を使う。OGP未表示は完了報告へ残す。URLが消えた、別URLになった、リンクとして機能しない場合は、それ以上の編集を止める。

## 見出し画像

見出し画像は記事先頭の見出し画像設定から登録する。本文の画像挿入ボタンへ誤って入れない。画像選択後に切り抜きや表示範囲の確認画面が出た場合は、主役や文字が切れていないことを見てから保存する。

## 差し絵

差し絵は指定された大見出し内の指定段落直後へ一枚だけ入れる。

1. 指定段落の末尾へカーソルを置き、必要な分だけ改行して空の段落を作る。
2. 現在表示される追加メニューを開き、画像追加を選ぶ。
3. ファイル選択画面で、指定された画像ファイル名と種類を確認して選ぶ。関係のないファイルを推測で選ばない。
4. 画像が指定位置に一枚だけ表示されるまで待つ。重複した場合は続行しない。
5. 画像の`代替テキスト`または同等の操作を開き、渡されたALTを入力して適用する。ALTは画像に見える人物、物、動作、関係だけを表す平文とし、記事タイトル、宣伝文、キーワード列、URLを入れない。
6. キャプションが渡されている場合だけ、画像のキャプション欄へ一致する文を入力する。渡されていなければ作らない。
7. 指定段落との位置関係、画像、ALT、キャプションを確認する。

画像がローカルファイルとして見えない、誤った画像を選んだ、アップロードが完了しない場合は、登録済みと装わず止める。

## 保存して閉じる

`保存済み`、`下書きを保存しました`、保存中表示の解消等、その時点のUIで確認できる保存根拠を一つ以上得る。明示的な`下書き保存`操作がある場合はそれを使い、`公開に進む`は押さない。

保存完了後にエディターを閉じる。`これは公開前の下書きです`等の表示または下書き一覧で、非公開の下書きとして残っていることを確認する。下書きURLを取得し、公開URLと呼ばない。

## UI変更時

目的のボタンや状態を特定できない時は、近いボタンを推測で押さない。現在の画面で確認できたことと、利用者に必要な一操作だけを伝えて停止する。