cloud-worklog
クラウド実行(Codex Cloud / Claude Code on the web)で、実質的な作業をしたターンの終わりに作業ログを1件残して送る。コード・設定・文書を変えた、テストを走らせた、調査の結論が出た、失敗して止まった、のどれかなら使う。質問に答えただけのターンでは使わない。ローカルでは使わない(ローカルは project-log)。
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- cloud-worklog
- description
- クラウド実行(Codex Cloud / Claude Code on the web)で、実質的な作業をしたターンの終わりに作業ログを1件残して送る。コード・設定・文書を変えた、テストを走らせた、調査の結論が出た、失敗して止まった、のどれかなら使う。質問に答えただけのターンでは使わない。ローカルでは使わない(ローカルは project-log)。
03 SKILL.md 正文
cloud-worklog — クラウドの作業をターンごとに記録する
クラウドからは Obsidian の Vault に直接書けない。1ターン1ファイルの Markdown を作り、
書き込み専用の受け口(Google Apps Script)経由で Google Drive の決まったフォルダへ送る。
記録の失敗で作業を止めない。 ローカルで動いているとき(AGENT_RUNTIME も CLAUDE_CODE_REMOTE も無い)は使わない。
いつ書くか
ターンの最後、最終返答の直前に1回。Claude Code では、変更があったのに記録が無いと Stop hook が1回だけ促す。
書き方
python3 .agent-kit/bin/agent-log turn \
--title "短い題(何をしたか。30字程度)" \
--purpose "このターンの目的(依頼の要約を1〜2文)" \
--done "実施内容。箇条書き可(- で始める)。なぜそうしたかを1行添える" \
--tests "実行したテストと結果(例: npm test: 42 passed / pytest -k auth: 1 failed)" \
--failures "失敗・詰まった点(なければ省略)" \
--todo "未完了・次にやること・本人の判断が要る点(なければ省略)" \
--pr "PR の URL(あれば)"
長いときは JSON を標準入力で渡せる(--json -。キーは同じ名前、値は文字列か文字列の配列)。
自動で入るもの: 日時(JST)、サービス、セッション、ターン番号、UUID、リポジトリ、ブランチ、HEAD、
基点からのコミットと変更ファイル、未コミットの変更、セッション URL(Claude)、セットアップの失敗の有無。
守ること
- 秘密を書かない: トークン・鍵・パスワード・
.envの値・認証付き URL は書かない。 ツールも既知の形式を[REDACTED]に置き換えるが、それに頼らない。 - 生ログを貼らない: テスト出力やスタックトレースは要点(失敗したテスト名と1行の原因)だけ。
- 事実だけ: 実行していないテストを「通った」と書かない。未確認は未確認と書く。
- 作業ログのファイルを編集・削除しない。別サービスのログを送らない(ツールが自動で除外する)。
- 最終返答の末尾に1行で報告する:
📝 作業ログ: <ファイル名>(送信済み)または(未送信)。
送れなかったとき(UNSYNCED)
- 未送信のログはリポジトリの外(状態ディレクトリの outbox)に残り、次のターン・次のセッション開始時に 同じ ID・同じ内容で再送される。Git にコミットしない(既定)。
- VM が消えると outbox も消えるため、UNSYNCED のときは最終返答の最後に
python3 .agent-kit/bin/agent-log show latestの出力を<details>で添える(会話の記録に残す)。 - 状態の確認:
python3 .agent-kit/bin/agent-log status。再送:python3 .agent-kit/bin/agent-log sync。
04 同仓库更多 Skills
vault-like
Synthetic test fixture for rejecting local-only skills.
doc-skill
テスト用。本文だけのスキル。
publish-polish
対外文章(PR のタイトル・本文、リリースノート、README など外に出す文書)を公開する前に、Gemini で推敲し、差分を確かめてから公開するときの手順。PR を作る・PR の本文やタイトルを変える・リリースを作る・README を含む push をするときに必ず使う。技術レビュー・承認・マージ判断には使わない。
pr-review
PR を実装担当とは別のセッションでレビューし、最新コミットについての判定を記録する。「PR
issue-task
GitHub の Issue を拾って実装するときの手順(担当確保・feature ブランチ・draft PR・依存の確認・テスト・レビュー依頼まで)。「Issue をやって」「#123 を実装」「次の Issue を拾って」で使う。レビューやマージ判定には使わない(それは pr-review)。