nananaman/nananaman-skills
Japanese workflows for engineering, writing, skill maintenance, Git and Sakura Cloud.
APM で agent skill を管理または更新するときに使う。apm.yml、参照方式（path / SHA pin）、グローバルインストール、dotfiles 連携の手順を確認する。
Appleのcontainer CLIでコンテナ・image・network等を操作・診断する。Docker/PodmanやComposeの操作には使わない。
CHANGES.mdがあるrepositoryで、差分から読み手に必要な変更履歴を書く。CHANGES.mdがない場合は自動起動せず、新規作成の明示依頼がある場合だけ作成する。release noteやPR用entryの明示依頼にも使える。
Git操作とGitHub PRに、プロジェクトの明文化された規則を優先して個人の運用規約を適用する。
文書、記事、実験・検証報告、解説、設計・判断資料、HTML reportなどを、読者と目的に合わせて設計し、根拠と不確実性を保って執筆・推敲・レビューするときに使う。日本語の読みやすさ、不自然な定型句、AIらしい均質な構成の点検も含む。PRDやDesign Docなど既存形式がある場合は、その要求を守りながら共通の文書設計とレビューを適用する。
依頼・issueから、調査と独立レビューを伴う一時的な実装計画を作る。計画作成の依頼に使い、通常実装や永続Design Docには使わない。
現在の branch から GitHub PR を作成する。通常は draft にし、ready PR はユーザー明示指示時だけ許可する。PR template、diff、commit、テスト状況を整理する。
技術改善・設計変更の問題と制約、候補を整理し、Design Doc草案を作る。PRD作成や実装計画は扱わない。
新機能・仕様変更の問題、対象ユーザー、要求を整理し、比較・判断できるPRD草案を作る。技術設計は扱わない。
Excalidraw の手描き図を編集可能な .excalidraw とローカル PNG にする。アーキテクチャ図・データフロー・処理フローの作成や既存図の編集、公式 CLI での描画に使う。
計画・設計・要求の重要な未決定事項を、一問ずつ詰めて共有理解を作る。単なる実装や実装済み差分レビューには使わない。
現在の会話を、別の agent が引き継げる引き継ぎ文書に圧縮する。
コード・設定・agent指示の変更や、振る舞いを保つリファクタリングを、検証と差分レビューまで完了させる。調査・計画・レビューだけの依頼には使わない。
nono sandboxのアクセス拒否を診断し、必要最小限のprofile修正と検証を行う。拒否と無関係なCLI障害には使わない。
Design Doc草案の採用案・詳細設計・リスク評価を完成させ、設計判断とタスク分割に使える文書に仕上げる。
PRD草案の未決定要求を解消し、価値・範囲・成功条件を判断できる文書に仕上げる。
設計上の重要な不確実性を、使い捨ての試作や実験で確かめる。比較案の操作・観察や技術的成立性の確認に使い、本番実装は扱わない。
コード・設定の差分を、専門担当と敵対的担当が独立レビューする。PRや実装差分の不具合・過剰設計の評価に使い、修正は行わない。
作成済みの実装計画を独立レビューし、実現性と不要な複雑性を評価する。計画の作成・修正には使わない。
さくらのクラウド EventBus の実行設定、スケジュール、イベントトリガーを設計・作成・確認する。SimpleMQ / シンプル通知への定期実行やイベント駆動実行を扱うときに使用。
さくらのウェブアクセラレータ（CDN）のサイト追加、独自ドメイン設定、キャッシュ削除、オリジンガード、SSL 証明書、Terraform 設定を扱うときに使用。
さくらのクラウド Workflows の YAML 作成、式のデバッグ、HTTP/API 呼び出し、実行履歴確認、失敗調査、キャンセルを扱うときに使用。
本人・所属組織が管理するスキルを実務の振り返りから保守する。許可されたCodex履歴とWorkの自己振り返りを全件読み、改善候補だけskill-workbenchで評価してdraft PRへ進める。第三者OSS・vendorスキルの改変には使わない。
skillやAGENTS.md・tool指示を作成・改善・レビューする。実行結果から更新方向を診断し、候補の比較・採用と、統合・廃止を含む構造探索を行う。
合意済みの要求・設計を独立実行可能なタスクへ分割し、依頼に応じてtrackerへ作成する。個別の実装計画は扱わない。
実行コードの振る舞い・API・型・schemaの処理規則の変更を、公開契約単位のTDDで進める。宣言的設定・文書・skillは明示的なTDD指定時に扱う。
テストの追加・修正・レビューで、命名、Arrange/Act/Assert、fixtureやmockを既存スタイルと公開契約に合わせる。単なるテスト実行には使わない。
APMのskill依存を最新化し、manifest・正本・展開先を同期する。本文の改善や通常のpackage更新には使わない。