mcpField
W
work-report

work-report

github.com/leeguooooo生産性6100 回インストール3 週間前に更新
リポジトリ

work-report について

複数リポジトリのGitコミット内容から日次・週次の業務レポートを作成するCodexスキルです。項目をプロジェクト別にまとめ、表現を整えて中国語の形式で出力します。

主な機能

  1. 01複数リポジトリのコミット収集
  2. 02プロジェクト別に項目を整理
  3. 03日次・週次の期間に対応
  4. 04コミットの表現を整える
  5. 05中国語の番号付きレポートを作成

活用シーン

  1. 01リポジトリのコミットから日次レポートを作成
  2. 02プロジェクト別に週次変更を要約
  3. 03ネストされたGitリポジトリのコミットを収集

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/leeguooooo/work-report --skill work-report

インストール後、Claude Code で/work-reportを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
LICENSE
scripts/
git_today_commits.sh

詳細

作業報告

ワークフロー

  • 現地の日付を確認し、MM.DD（年なし）の形式にします。
  • ユーザーの依頼に応じて、日次か週次かを決めます。
  • 複数のリポジトリをスキャンするため、ワークスペースのルートパスを確認します。ユーザーから指定がない場合は、まず WORK_REPORT_ROOT または CODEX_WORK_ROOT を確認してから、ユーザーに尋ねます。
  • 日次レポートでは、対象ルート配下のすべてのリポジトリを対象に、作成者ごとに Git のコミットの件名を収集し、プロジェクト（リポジトリ）ごとに分類します。
    • できるだけ scripts/git_today_commits.sh --root <path> --period daily --group-by-repo を使います。
    • 必要に応じて、リポジトリごとに手動で実行します：git log --since=midnight --author "<name>" --pretty=format:%s。
    • コミットの件名を簡潔な中国語の項目に書き換え、各プロジェクトの下に番号付きリストとしてまとめます（英語で出力しないでください）。「解决冲突」など、価値の低い表現や機密性のある表現は、「代码集成与稳定性维护」など、業務に適した表現に置き換えます。
    • コミットがない場合は、ユーザーに手動で項目を提示するよう依頼します。
  • 週次レポートでは、Git のコミットを簡潔な中国語の項目に要約し、プロジェクトごとに分類します（コミットがない場合を除き、ユーザーへの入力依頼は不要です）。
    • できるだけ scripts/git_today_commits.sh --root <path> --period weekly --group-by-repo を使います。
    • コミットの件名を、プロジェクトごとに1～5件の中国語の要約項目にまとめます（類似する変更は統合します）。
  • .git ディレクトリまたはファイルがあるディレクトリのみをプロジェクトとして扱います。Git 管理外のディレクトリは無視します。ルート配下のネストされたリポジトリも含めます。

スクリプト

コミットの件名を一覧表示するには、scripts/git_today_commits.sh を使います。

  • このスキルのディレクトリにいない場合は、~/.codex/skills/work-report/scripts/git_today_commits.sh（または $CODEX_HOME/skills/work-report/scripts/git_today_commits.sh）を使って呼び出します。
  • --repo が指定されているか、WORK_REPORT_ROOT/CODEX_WORK_ROOT が設定されていない限り、--root <path> は必須です。
  • 作成者の既定値は、git config --global user.name、次に git config --global user.email から取得します。
  • 別のルートフォルダーを対象にするには、--root <path> を使います。
  • 単一のリポジトリを対象にするには、--repo <path> を使います。
  • 作成者を指定するには、--author "Name" を使います。
  • 期間を選ぶには、--period daily|weekly を使います。
  • 期間を上書きするには、--since "<expr>" を使います（例："yesterday"）。
  • 各項目の先頭にリポジトリ名を付けるには、--with-repo を使います。
  • レポートにまとめやすいよう、リポジトリごとにセクションを分けて出力するには、--group-by-repo を使います。
  • 既定では、すべてのブランチからコミットを収集します（git log --all）。現在のブランチに限定するには、--no-all を使います。
  • 既定では、項目を業務に適した表現にするための正規化が有効です。コミットの件名をそのまま使うには、--no-normalize を使います。

出力形式

日次レポートの見出しには「今日工作总结」を使います。スクリプトが箇条書きを出力した場合は、番号付きリストに変換します。

MM.DD 今日工作总结
<项目A>
1.<item>
2.<item>
<项目B>
1.<item>

週次レポートの見出しには「本周工作总结」を使います。週次の項目は、Git のコミットから作成した中国語の要約です。期間は、月曜日を週の始まりとする自然な週に従います。

MM.DD-MM.DD 本周工作总结
<项目A>
1.<item>
2.<item>
<项目B>
1.<item>

コメント

Markdown 対応