القائمة
Defines the standard format and rules for git commit messages in this project.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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
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 監査。