From syou6162-claude-code-commands
Creates and updates structured development diaries on esa using esa-llm-scoped-guard CLI. Activates on Japanese triggers like '開発日誌を作って' for new posts or '開発日誌更新' for updates with/without URL.
npx claudepluginhub syou6162/agent-skillsThis skill uses the workspace's default tool permissions.
esaに開発日誌を投稿・更新するスキルです。`esa-llm-scoped-guard` CLIを使用して、許可されたカテゴリ配下の記事のみを安全に編集します。
Creates and maintains DEVLOG.md logging project evolution, decisions, challenges from git repo, Claude chat history, planning docs. For progress updates, milestones.
Automates isolated daily dev logs for multi-project development by summarizing conversation progress, Git commits, and changes into project-specific Markdown files.
Logs factual progress from git work sessions (detected via 3-day gaps) to a global markdown file after sprints, phases, or milestones. Useful for 'document my progress' or post-repo work.
Share bugs, ideas, or general feedback.
esaに開発日誌を投稿・更新するスキルです。esa-llm-scoped-guard CLIを使用して、許可されたカテゴリ配下の記事のみを安全に編集します。
.claude_work/dev_diary.yamlに作成すること（ファイル名固定）create_esa_post, update_esa_post, read_esa_post, read_esa_multiple_posts, search_esa_posts）は使用禁止。既存記事の取得には必ず esa-llm-scoped-guard fetch コマンドを使用することesa-llm-scoped-guard fetch で取得した .claude_work/dev_diary.yaml を参照するよう指示すること。esa MCPツールで直接取得させてはいけないesa-llm-scoped-guard -helpで確認してから生成すること.claude_work/ は .gitignore の対象であり、リポジトリの変更にならないため、Planモードでも書き込みが許可されている。esa-llm-scoped-guard コマンドの実行も同様。「Planモードだからできない」と拒否してはいけない`xxx`）またはコードブロック（```）で囲む良い例（箇条書き・ネスト活用・情報完全）:
tasks:
- description: BigQueryクエリ最適化
status: completed
details:
背景: 月次集計クエリが30分以上かかっている
アプローチ:
- パーティションプルーニングの適用
- 不要カラムの除外（SELECT * → 必要カラムのみ）
- マテリアライズドビューの検討
結果: 実行時間を30分→5分に短縮
悪い例（構造化不足・省略）:
BigQueryクエリを最適化した。パーティションプルーニングの適用と不要カラムの除外により、月次集計クエリの実行時間を改善した。マテリアライズドビューも検討した。
以下のトリガーワードで発動します：
最初に必ず最新のYAMLスキーマを確認してください：
esa-llm-scoped-guard -help
| トリガー | URL確認 | 次の手順 |
|---|---|---|
| 「開発日誌を作って」 | 不要 | 手順4（新規作成） |
| 「開発日誌を更新」+ URL | URLあり | 手順3（更新） |
| 「開発日誌を更新」（URLなし） | ユーザーに確認 | URL取得後、手順3または手順4 |
新規作成モードで、手順4（YAML更新）へ直行してください。
ユーザーが提示したesaのURLからpost_numberを抽出（例: https://yasuhisa.esa.io/posts/123 → 123）
手順3（YAML取得）へ進む
ユーザーに質問して、開発日誌のURLを確認：
URLが提供された場合:
post_numberを抽出新規作成を選択した場合:
目的: 既存記事からYAMLを取得し、差分ゼロの状態を作る
fetchコマンドで既存記事からYAMLを直接取得：
esa-llm-scoped-guard fetch -post <post_number> | tee .claude_work/dev_diary.yaml > /dev/null
fetch成功の場合: YAMLが取得できたので、そのまま手順4へ進む（差分ゼロ確認は不要）
fetch失敗の場合: 古い形式（YAML埋め込みなし）の記事のため、更新はできません。ユーザーに以下を報告してください：
esa-llm-scoped-guardでの更新ができませんWriteツールで.claude_work/dev_diary.yamlを作成（ファイル名固定、常に上書き）
YAMLの構成内容：
create_new: trueを指定、post_numberは含めないcategory: Claude Code/開発日誌/yyyy/mm/dd形式（今日の日付）name: 日付ベースのタイトルbody: 会話コンテキストから抽出したタスク情報を構造化形式で作成手順3で取得したYAMLに変更を加える（Editツール使用）
category、name、post_numberは維持すること（create_newは含めない）GitHub URL状態の確認と反映:
a. body.tasksからgithub_urlsを抽出（URLがなければスキップ）
b. 各URLの状態と内容をgh CLIで確認
PRの場合:
gh pr view <URL> --json state,isDraft,title,body
Issueの場合:
gh issue view <URL> --json state,title,body
c. に従ってGitHub状態を判定
d. に従ってタスクstatusを更新
e. タスクdescriptionの更新要否を判定（参照）
以下のいずれかに該当する場合、タスクdescriptionを更新：
| 判定条件 | 説明 |
|---|---|
| タイトル差分 | GitHubタイトルがタスクdescriptionと実質的に異なる（スコープの追加・削除） |
| 本文の追加スコープ | bodyに、タスクdescriptionにない追加機能・領域が記載されている |
| 前提/実装変更 | bodyに前提や実装アプローチの変更が記載されている |
更新内容の形式：
validateで形式確認：
esa-llm-scoped-guard validate -yaml .claude_work/dev_diary.yaml
diffで差分が意図通りか確認：
esa-llm-scoped-guard diff -yaml .claude_work/dev_diary.yaml
+で表示される（全体の最終確認）ユーザーの承認後、投稿を実行：
esa-llm-scoped-guard post -yaml .claude_work/dev_diary.yaml
| リソース | 条件 | 判定結果 |
|---|---|---|
| PR | state=MERGED | マージ済み |
| PR | state=OPEN, isDraft=true | ドラフト（WIP） |
| PR | state=OPEN, isDraft=false | レビュー中 |
| PR | state=CLOSED | クローズ |
| Issue | state=OPEN | オープン |
| Issue | state=CLOSED | クローズ済み |
| GitHub状態 | タスクstatus |
|---|---|
| PRがマージ済み | completed |
| PRがドラフト（WIP） | in_progress |
| PRがレビュー中 | in_review |
| PRがクローズ（マージなし） | （変更なし） |
| Issueがクローズ | completed |
| Issueがオープン | （変更なし） |