Menú
新しい k8o プロジェクト/リポジトリを立ち上げる一連の手順。@k8o/create で雛形生成 → GitHub リポジトリ作成 → ブランチ保護 ruleset とマージ設定 → リリース用 secret(fnox経由) → npm 初回 publish と Renovate 有効化まで。「新しい repo を作る」「プロジェクトを立ち上げる」「リポジトリの初期設定をする」ときに使用する。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。
Preview generated Markdown (plans, design notes, reviews, research reports) in the user's browser. Use when sharing long, structured output — documents with headings, tables, code blocks, or Mermaid diagrams — that is hard to read in the terminal.
バグを場当たり修正せず、根本原因を特定してから直すためのデバッグ手順。再現→切り分け→根本原因→検証の順で進める。バグ・デバッグ・原因不明・落ちる・再現しない・CIが赤・flakyなテスト・想定外の挙動に遭遇したときに使用する。「デバッグして」「なぜ落ちる」「原因を調べて」などのときにも使用する。
「完了」「直した」と報告する前に、実際に実行・テスト・観察して根拠を確かめるための検証ルール。修正・実装・リファクタが終わって成功を報告しようとするとき、変更が意図どおり動くと主張する前に使用する。「できた」「直した」「実装した」「修正完了」と言おうとしているときに使用する。
日本語の技術文書を書いた後・公開前にレビューし、重要度つきの指摘レポートを出すスキル（ファイルは変更しない）。日本語の文章品質・AI Slop・表記の慣習・整合性・独自性・語り口を点検する。媒体非依存の汎用版で、ブログMDXなどプロジェクト固有のレビュースキルがあればそちらを優先・併用する。
Conventional Commitsに従ったアトミックなgitコミットを作成する。変更を論理単位に分割し、独立してrevert可能なコミットを生成する。コードの変更をコミットしたいとき、コミットメッセージを作りたいときに使用する。
| name | new-project |
| description | 新しい k8o プロジェクト/リポジトリを立ち上げる一連の手順。@k8o/create で雛形生成 → GitHub リポジトリ作成 → ブランチ保護 ruleset とマージ設定 → リリース用 secret(fnox経由) → npm 初回 publish と Renovate 有効化まで。「新しい repo を作る」「プロジェクトを立ち上げる」「リポジトリの初期設定をする」ときに使用する。 |
@k8o/create（Vite+ ジェネレーター, repo: k35o/templates）で雛形を作り、GitHub リポジトリを @k8o 標準（ブランチ保護・リリース・Renovate）で立ち上げる runbook。<name> は scope を除いたパッケージ名（例: @k8o/foo → foo）。
vp create @k8o / pnpm create @k8o / npm create @k8o はどれも同一 bin を実行する（3 入口とも有効）。
vp create @k8o # 対話: library / web を選び、パッケージ名 @k8o/foo を入力
# 非対話:
vp create @k8o -- --kind library --name @k8o/foo --description "..." --directory ./foo
kind=library: 単一 TS ライブラリ（vp pack）。kind=web: React monorepo（packages/<name> + apps/playground, @k8o/arte-odyssey 利用）。minimumReleaseAge(7日) のため、@k8o/create の 当日公開版は約7日間ローカルで引けない（古いキャッシュを掴む）。即使うなら一時的に npm_config_before= を解除して実行。cd foo
mise trust
pnpm install
git init -b main && git add -A
git commit -m "feat: ..." # 署名コミット (ruleset で必須)
gh repo create k35o/<name> --public --source=. --remote=origin --push \
--description "..."
gh api repos/k35o/<name> -X PATCH \
-F allow_squash_merge=false -F allow_rebase_merge=false -F delete_branch_on_merge=true \
-F allow_auto_merge=true
allow_auto_merge=true は Renovate の自動マージ（:automergeMinor + デフォルトの platformAutomerge）が GitHub ネイティブ auto-merge を使うために必須。無効だと Renovate は自前 automerge にフォールバックし、定期実行時に PR が全 green だったときしかマージされず取りこぼす。required_approving_review_count が 0 であること。承認必須にすると bot は自分の PR を承認できず automerge が止まる（ruleset の bypass_actors に Renovate を入れても、bypass はルール単位でなくセット全体に効くため CI チェックまでスキップしてしまい不可）。本テンプレは次節で 0 にしてある（CI ゲートは required_status_checks で別途担保）。oxc-config 流: 削除/force-push 禁止・署名必須・PR 必須(承認0 / merge のみ)・CI green 必須・Admin は bypass。承認は 0（CODEOWNERS 無効）— ソロ開発かつ Renovate automerge を効かせるため（承認必須だと bot PR が止まる）。レビューを強制したい repo は required_approving_review_count を上げる（その場合 Renovate PR は手動マージになる）。
gh api repos/k35o/<name>/rulesets -X POST --input - <<'JSON'
{
"name": "main",
"target": "branch",
"enforcement": "active",
"conditions": { "ref_name": { "include": ["~DEFAULT_BRANCH"], "exclude": [] } },
"rules": [
{ "type": "deletion" },
{ "type": "non_fast_forward" },
{ "type": "required_signatures" },
{ "type": "pull_request", "parameters": {
"required_approving_review_count": 0,
"dismiss_stale_reviews_on_push": false,
"require_code_owner_review": false,
"require_last_push_approval": false,
"required_review_thread_resolution": false,
"allowed_merge_methods": ["merge"]
} },
{ "type": "required_status_checks", "parameters": {
"strict_required_status_checks_policy": false,
"required_status_checks": [
{ "context": "Lint / Format / Types" },
{ "context": "Tests" },
{ "context": "Changeset" }
]
} }
],
"bypass_actors": [ { "actor_id": 5, "actor_type": "RepositoryRole", "bypass_mode": "always" } ]
}
JSON
required_status_checks の context は ci.yml の job name: と完全一致させる。library 雛形は Lint / Format / Types / Tests / Changeset、web 雛形は Build / Lint / Types / Tests / Changeset。required_status_checks ルールを省く（oxc-config の初期はこれ）。release.yml は client-id（app-id は legacy）+ private-key を使う。secret は repo ごとに必要。値は fnox の tier2 プロファイル [profiles.bot] に登録済み（K35O_BOT_CLIENT_ID / K35O_BOT_PRIVATE_KEY）。シェルには常駐しないので -P bot で取り出す。
fnox exec -P bot -- gh secret set K35O_BOT_CLIENT_ID -R k35o/<name> --body "$K35O_BOT_CLIENT_ID"
fnox exec -P bot -- gh secret set K35O_BOT_PRIVATE_KEY -R k35o/<name> --body "$K35O_BOT_PRIVATE_KEY"
fnox set した値を見えないことがある（空値が入る）。その場合は Bash の fnox exec(CLI は都度読込) か、非機密の値は直接 gh secret set で。NPM_TOKEN 不要・provenance 付き）。npmjs.com で対象パッケージの trusted publisher を k35o/<name> の release workflow に設定する。PUT ... 404）。初回だけ:
npm login・2FA OTP。ローカルは provenance 不可なので無効化）:
npm_config_provenance=false pnpm publish --access public --no-git-checks
pnpm changeset → main マージ → Release ワークフローが自動 publish。github>k35o/renovate-config を extends）。k35o/<name> を追加。ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING）。CLI/ジェネレーター系パッケージは必ず vp pack で JS にビルドし dist/*.mjs を bin にする（@k8o/create 対応済み）。minimumReleaseAge(7日) で自分の当日公開版がローカルで引けない。git config commit.gpgsign true 等を確認（詰まったら Admin bypass）。