SQUAREONE Operating Docs

← ドキュメントに戻る

スキルを申請

再利用したい仕事をスキルとして整え、GitHubのプルリクエストで提出します。リポジトリ管理者が内容・権限・リスクを確認し、承認された内容だけがSQUAREONE Operating Docsへ版付きで公開されます。

申請テンプレートを開く → 公開済みスキルを見る
公開までの流れ
あなた(寄稿者)
Coworkで
レシピを書く
あなた(寄稿者)
「提出」を
頼む(PR)
自動(GitHub)
構造・秘密・権限を
検査する
リポジトリ管理者
内容と権限を確認し
承認する
自動(Operating Docs)
版付きで蓄積し
安全性を記録
承認済みの公開処理
検証済みの版だけが
公開環境へ反映される
Skill · 実行スキル

再利用できる仕事をスキルにする

S

「実行スキルとして申請」と伝える

通常の記事やレシピと同様に、実行を伴うスキルもプルリクエストで申請します。実行スキルの場合は、作業環境へ実行スキルとして申請と伝えてください。専用テンプレートに沿って、使う場面・作業手順・禁止事項・必要な権限を揃えます。

Cowork にこう頼む 「〇〇の仕事を代行するスキルを作って。実行スキルとしてプルリクエストで申請して。」

承認されたすべてのコンテンツが自動実行されるわけではありません。実行可否とリスクを分けて管理し、APIキーなどの秘密値を含む申請、高リスクで未確認の申請は自動搭載されません。

初めて申請する人向け:GitHubとCoworkの準備
A · Setup

最初の一度だけの準備

1

GitHub アカウントを作る

GitHub は「みんなで同じファイルを安全に更新する」ための置き場所です。無料で作れます。

  1. github.com/signup を開く
  2. メールアドレス → パスワード → ユーザー名(半角英数。例: docs-editor)を順に入力
  3. 確認コードがメールに届くので入力して認証
  4. プランを聞かれたら Free(無料) でOK

できたら、決まったユーザー名をリポジトリ管理者へ伝えてください。共同編集者への招待に必要です。

2

大辞典リポジトリへの招待を受ける

リポジトリ管理者があなたのGitHubユーザー名宛に共同編集者の招待を送ります。GitHubまたは通知メールから Accept invitation(招待を受ける) を選びます。

招待の承認後も、変更はプルリクエストと管理者レビューを通過するまで本番へ公開されません。

3

作業環境と GitHub をつなぐ

利用中の作業環境で接続済みのGitHub Appを選び、GitHubのOAuth画面でアクセスを承認します。対象は招待を受けたリポジトリに限定し、画面に表示された権限を確認してから続行してください。

個人アクセストークンを人から受け取ったり、チャットへ貼り付けたりしません。接続はGitHubの設定画面からいつでも取り消せます。公開は引き続きプルリクエストの承認後だけです。

B · 毎回の作業

更新するとき

4

Cowork でレシピ・ワークフローを書く

新しい仕組みやレシピを、いつもどおり Cowork に作ってもらいます。たとえば:

Cowork にこう頼む 「大辞典に新しいレシピを追加したい。〇〇という仕組みを、辞典のフォーマットに合わせてページにして」

Cowork が辞典の中の正しい場所にページを作ります。中身の体裁は Cowork が整えてくれるので、あなたは「何を載せたいか」を伝えるだけでOKです。

5

「提出」を頼む(プルリクエスト)

書けたら、そのまま提出を頼みます。作業環境が「自分用の作業枝(ブランチ)」を切り、変更をまとめて、リポジトリ管理者が確認できる提出(プルリクエスト=PR)を作ります。

Cowork にこう頼む 「今の変更をプルリクエストで提出して。公開前の確認用として作って。」

本番(公開サイト)には、この時点ではまだ反映されません。あくまで「提出箱」に入れただけです。

6

プレビューURLで「試し見」する

提出すると、その内容だけが反映されたプレビュー用のURLが自動で発行されます(本番そっくりの別アドレス)。公開前に、自分の更新が崩れていないか・意図どおりかをここで確認できます。

プレビューURLは提出(PR)の画面に自動で表示されます。Cowork に「プレビューURLを教えて」と聞けば取り出せます。

7

管理者が確認 → 公開

提出が出るとリポジトリ管理者に通知が届きます。内容・必要な権限・自動検査の結果を確認し、公開してよければ承認(マージ)します。承認された版だけがSQUAREONE Operating Docsへ反映されます。

修正が必要な場合は、管理者がプルリクエストへコメントします。同じブランチを直してプッシュすれば提出が更新されるため、作り直す必要はありません。

C · ルール

守ること・やらないこと

これはやる

  • 作業を始める前に Cowork に「最新を取ってきて」と頼む
  • 更新は必ず「提出(プルリクエスト)」の形で出す
  • 公開前にプレビューURLで自分の目で確認する
  • 管理者から修正依頼が来たら、同じ提出を直して更新する

これはやらない

  • 本番(main)を直接編集しない。必ず提出経由で
  • Vercel への直接デプロイはしない(鍵も渡されません)
  • 他の人の提出を勝手に承認・マージしない
  • 大きな削除や作り直しは、先にリポジトリ管理者へ相談する
D · FAQ

よくある質問

提出したら、すぐ公開されちゃう?+
いいえ。提出(プルリクエスト)は管理者への確認依頼です。承認されるまで本番には反映されません。公開前にプレビューで確認できます。
間違えて変なものを提出してしまった+
提出はあとから直せます。作業環境に「さっきの提出を直して」と頼めば、同じ提出を更新できます。取り消す場合は、GitHubでプルリクエストを閉じるか、管理者へ依頼してください。本番は変更されません。
他の人と同じ場所を同時に編集したら、ぶつからない?+
各自が別々の「作業枝(ブランチ)」で進むため、いきなり本番を上書きすることはありません。同じ箇所が重なった場合は、管理者レビューの前に競合を解消します。困ったら作業環境に「競合がないか確認して」と頼んでください。
ターミナルやコマンドは本当に使わなくていい?+
通常は作業環境へ日本語で頼むだけで完結します。初回接続もGitHubのOAuth画面で承認するため、個人アクセストークンの受け渡しやチャットへの貼り付けは不要です。
プレビューURLはどこで見られる?+
提出(プルリクエスト)の画面に自動で表示されます。わからなければ Cowork に「この提出のプレビューURLを教えて」と聞けば取り出してくれます。