원클릭으로
commit-standard
Defines the standard format and rules for git commit messages in this project.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
Defines the standard format and rules for git commit messages in this project.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
CSW のユーザー向け UI・コピーの正典。ユーザー向け語彙(「環境」)、共有モードの3語(共有/分離/コピー)、選択行の見せ方(塗りのみ)、メニューバーを主機構にしない、コピーの一次ソースは LP、Claude 本体の現行用語への追従、並列 UI の分量・文体、禁止記号(em-dash/※/絵文字)を定める。アプリ UI・LP・docs のラベル/モード名/説明文/マイクロコピーを作る/変える前に読む。
用語・概念・UI・コピーを1箇所変えたら、全サーフェス(アプリ UI・トレイ・docs ja/en・README ja/en・LP ja/en・スクリーンショット・OG 画像)へ同時反映し、旧表現を全リポ grep で残存ゼロ確認する。スクショ等の非テキスト派生物は grep に映らないので明示列挙して再生成する。UI・用語・コピーを変えたら発動。
PR をマージする際のレビュー・マージ実行チェックリスト (Rust + Tauri v2 / CSW)。スコープ外変更・安全装置の格下げ・テスト負債・高リスクインフラファイル改変を検出し、CI green を確認したうえで自律的に squash merge する手順を定義する。
CI (GitHub Actions の Test / Build / Security job) が想定時間を大幅に超過した場合のハング検出と cancel / rerun フロー。macos-latest runner の混雑や cargo の依存取得・コンパイル stall 等、transient な GHA 側障害の典型対処。CI が想定より長く `in_progress` のまま動かない時に発動。
日本語の見出し・本文の折り返し / タイポグラフィ品質ゲート。日本語 UI・LP・ドキュメントのコピーやフォントサイズ、改行、行間に触れる前に必ず読む。英語の折り返しルールをそのまま日本語に当てると崩れる(禁則・文節・字面密度が違う)ため、JP 専用の規則・モダン CSS・モジュラースケール・実機検証手順を正典化する。design-taste-frontend を補完する JP 特化スキル。
LP(website/) と人間向けドキュメント(docs/・README) と実装(crates/) が「同じ一つの事実」を語っているかを横断監査する。用語・アーキテクチャ・CLI 表面・機能主張・ja/en 整合・禁止表現を点検し、不整合を file:line と修正案つきで報告する。リリース前やドキュメント/LP/実装を変えた後に実行する read-only 監査。
| name | commit_standard |
| description | Defines the standard format and rules for git commit messages in this project. |
This project uses a standardized git commit message format based on Conventional Commits, with an added touch of our project's specific context.
<type>(<scope>): <subject>
<body>
<footer>
Must be one of the following:
feat: A new feature (e.g., adding a new user profile section)fix: A bug fix (e.g., fixing tooltip text)docs: Documentation only changes (e.g., updating README, SPECIFICATION, or USER_GUIDE)style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)refactor: A code change that neither fixes a bug nor adds a featureperf: A code change that improves performancetest: Adding missing tests or correcting existing testschore: Changes to the build process or auxiliary tools and libraries such as documentation generationこのリポジトリは release-please で版を管理する。fix: / feat: / 破壊的変更(! または BREAKING CHANGE)のいずれかが main に入ったときだけリリース PR が起票され、マージすると署名・公証つき DMG をビルドして GitHub Release を切る。docs: / chore: / style: / refactor: / perf: / test: / ci: は版を上げず、リリース PR を作らない。
判断基準は「出荷するアプリ本体(crates/)を変えるか」であって、概念的に bug fix かどうかではない:
crates/(core / cli / desktop のロジック)を変える → fix: / feat:(= リリース対象)website/(LP)・docs/・README だけ、または .agents/ のスキル・CI 補助だけ → docs: か chore: を使う。fix: / feat: は使わない理由: LP は GitHub Pages でアプリのリリースとは独立にデプロイされる。LP やドキュメントだけの変更で fix: を使うと、アプリのコードは何も変わっていないのに版が上がり、中身が前バージョンと同一の DMG をリリースしてしまう(2026-06-29、技術コラムとスクショを fix(website) で積んだ結果、ドキュメントだけの 0.9.2 リリース PR が起票された)。LP の不具合(リンク切れ・レイアウト崩れ)を直すときも、crates/ を触らないなら docs(website): を使う。
例:
docs(website): 技術コラムを平易な説明文に書き直す(LP のみ → リリースされない)docs: USER_GUIDE に環境切替の手順を追記する(docs のみ → リリースされない)fix(core): プロファイル名検証で日本語を許可する(アプリ変更 → リリース対象)Indicates the area of the codebase the commit affects. Common scopes in this project:
core: csw-core library (profile / switcher / linker / keychain / platform)cli: csw-cli command-line interfacedesktop: csw-desktop Tauri GUI (tray, settings UI)ci: GitHub Actions workflows, release toolingdocs: SPECIFICATION / USER_GUIDE / READMEwebsite: landing page (website/)feat(auth): add OAuth login support
Implement Google and GitHub OAuth providers for faster user onboarding and integrate them into the login screen.
## Agent Instructions
When you are asked to commit changes, ALWAYS reference this skill and follow the format precisely. If committing multiple diverse changes, try to group them logically or use `feat(core)` / `chore(all)` if they span the entire project.
**CRITICAL RULE FOR THE AGENT (Claude Code):**
1. All commit subjects and bodies MUST be written in **Japanese (日本語)**, regardless of the prompt language. The `<type>(<scope>)` prefix remains in English.
Example: `feat(core): プロファイル複製コマンドを追加`
Commit only when the user asks. End commit messages with the trailer `Co-Authored-By: Claude <noreply@anthropic.com>`.
2. **Untracked Files Check**: Before committing, ALWAYS ensure you haven't forgotten to stage newly created files (e.g., new workflow files, reports, components). Do not blindly use `git add file1 file2` without considering if you created `file3` during the task. Use `git add .` or explicitly add all relevant new files.
3. **対話エディタの回避**: Claude Code の Bash ツールは対話的エディタを開けないため、`git merge` や `git commit`(マージコミット等)でエディタが起動するとハングする。以下の対策を**必ず**実施すること:
- `git merge` → `git merge --no-edit <branch>` を使用
- `git commit`(マージコミット等) → `GIT_EDITOR=true git commit --no-edit` を使用
- **絶対にエディタが開くコマンドを素のまま実行しないこと**
## Branch Strategy
### 命名規則
- `feat/<short-description>` — 新機能
- `fix/<short-description>` — バグ修正
- `refactor/<short-description>` — リファクタリング
- `docs/<short-description>` — ドキュメント変更
### 運用ルール
1. **すべての変更**(コード・ドキュメント・plan ファイル含む)は必ず feature ブランチで作業する
2. PR を作成し、CI(`cargo fmt` / `cargo clippy` / `cargo test`)が全てパスしてからマージする
3. `main` への直接 push は禁止(GitHub branch protection rule で物理的に阻止されており例外はない)。ドキュメントのみの変更も feature ブランチ + PR 経由でマージする。詳細は [CLAUDE.md](../../../CLAUDE.md) の Branch Strategy Enforcement