commit-ja

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# 日本語コミットメッセージ

単独で起動されたら、すぐにメッセージを生成する。クライアントがコマンド文字列を省いても、入力が空かスキルの参照だけなら単独起動とみなす。別の依頼のコンテキストとして渡された場合は、その依頼に従う。

## 生成

1. `git status --short`、`git diff --cached --stat --patch`、`git log -8 --format='%s'` を並列で実行する。
2. ステージ済みの変更を根拠にし、最近の件名は書き方の参考にする。コミットがまだなければ履歴は省く。差分で判断しきれない点だけ追加で調べる。
3. メッセージだけを `text` コードブロック1つで返す。複数なら同じブロック内を `---` で区切る。ステージ済みの変更がなければ、そのブロックで `ステージ済みの変更はありません` と返す。確認に失敗したらエラーを報告する。

ファイルとインデックスは変更しない。了承の返事や再実行の依頼で終えず、結果を返す。

## 形式

`type(scope)!: subject` で書く。

- type: `feat`、`fix`、`docs`、`style`、`refactor`、`perf`、`test`、`chore`、`build`、`ci`、`revert`
- scope は英語、subject と本文は日本語で書く。scope は差分から判断できるときに付ける。
- subject は変更後の振る舞いを簡潔な名詞句で表す。ファイル名や `修正` 単独のような汎用語ではなく、意味のある語を入れる。
- subject は50文字を目安に72文字以内とし、末尾の句読点、チケット番号、URL、`〜しました` を含めない。
- 動機や影響の説明が要るときは本文を書く。
- 破壊的変更には `!` を付け、移行の説明が要るときは `BREAKING CHANGE:` フッターを加える。

独立した変更は分け、補助的なテストやドキュメントは対象の変更に含める。

```text
feat(auth): OAuth2ログインエンドポイントの追加

リフレッシュトークンを使ったセッション継続に対応。
```

## コミット

コミットは依頼されたときだけ作成する。一括ステージ、空コミット、フックの回避はしない。

1. ステージ済みの変更と関連する未ステージの変更を確認し、依頼されたパスやハンクだけをステージする。無関係な変更や部分的なステージは保つ。
2. 分けた変更ごとに、ステージ済みの差分とリポジトリが求めるチェックを確かめてからコミットする。メッセージは上の形式のプレーンテキストで Git に渡す。
3. 各コミットの後、コミットと残りの Git の状態を確認する。コミットやフックの失敗は報告する。

From imkohenauser/skills, MIT.

More from imkohenauser/skills