Codex Skillsで自分のワークフローを書く方法：繰り返しプロンプトから再利用可能なSKILL.mdへ

1
2
3
4
5

中国語記事を公開可能なブログ記事に整える
ログを日報にまとめる
PRをセキュリティ、回帰、テスト不足の観点でレビューする
build、sync、purge、submitを含むデプロイ手順を固定する
商品画像を一定仕様に正規化する

1
2

my-workflow/
  SKILL.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

my-workflow/
  SKILL.md
  references/
    checklist.md
    examples.md
  scripts/
    validate.ps1
    collect-data.py
  assets/
    report-template.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

---
name: my-workflow
description: Use when the user asks to <specific trigger>. Handles <input>, produces <output>, and verifies <completion criteria>.
---

# My Workflow

## Purpose

このskillが解決する反復タスクと、解決しないことを書く。

## When To Use

- ユーザーが特定のタスクを求めたときに使う。
- 固定手順、固定出力、固定検証が必要なときに使う。
- 普通のQ&Aでは使わない。

## Inputs

- ユーザーが提供すべきもの。
- リポジトリから発見できるもの。
- 不足時にどう仮定または質問するか。

## Workflow

1. 状態を確認する。
2. 必要なファイルを読む。
3. 中核処理を行う。
4. 軽量検証を行う。
5. 結果と残作業を報告する。

## Constraints

- 変更してはいけないファイル。
- 実行してはいけないコマンド。
- 保持すべきフィールド。
- 衝突時の扱い。

## Verification

- 出力ファイルを確認する。
- 形式を確認する。
- コマンド結果を確認する。
- 残リスクを確認する。

## Reporting

最終報告には、変更内容、未変更部分、検証結果、リスクを含める。

1

description: Help with reports.

1

description: Use when the user asks to turn Git commits, issue updates, or daily work notes into a weekly engineering report with sections for completed work, risks, blockers, and next actions.

1

あなたはシニアエンジニアです。この変更をレビューし、境界条件とテストを重点的に見てください。

1
2
3
4
5
6
7
8

## Workflow

1. `git status --short` を確認する。
2. 関連diffを読む。
3. スタイルより先に振る舞いの変化を見る。
4. 重大度順に findings を列挙する。
5. bug、回帰、安全性、テスト不足を優先する。
6. 問題がなければその旨と残テストリスクを書く。

1
2
3
4
5

## References

- レポート品質を判断するときだけ `references/report-rubric.md` を読む。
- 完全なテンプレートが必要なときだけ `assets/weekly-report-template.md` を読む。
- 短い要約タスクでは例文集を読まない。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

---
name: weekly-report
description: Use when the user asks to create a weekly work report from Git commits, notes, issue updates, or chat summaries. Produces a concise Chinese report with completed work, impact, blockers, and next week plan.
---

# Weekly Report

## Workflow

1. Confirm the report date range. If missing, use the current week.
2. Collect source material from user-provided notes first.
3. If the user asks to include Git work, run `scripts/collect-git-summary.ps1`.
4. Group work by project or theme, not by raw commit order.
5. Produce a concise Chinese report using `assets/weekly-report-template.md`.
6. Mark uncertain items as uncertain instead of inventing progress.

## Constraints

- Do not expose private commit hashes unless the user asks.
- Do not claim shipped work if the source only shows drafts or experiments.
- Keep blockers separate from completed work.

## Reporting

Return the report content and list which sources were used.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

---
name: focused-code-review
description: Use when the user asks for a code review of the current working tree, a commit, or a pull request. Prioritize bugs, regressions, security risks, and missing tests; do not rewrite code unless asked.
---

# Focused Code Review

## Workflow

1. Inspect `git status --short`.
2. Read the relevant diff.
3. Identify behavior changes before style issues.
4. List findings first, ordered by severity.
5. Include file and line references when possible.
6. If no issues are found, say so directly and mention remaining test gaps.

## Constraints

- Do not make code edits during review.
- Do not focus on formatting unless it can cause a real bug.
- Do not summarize before findings.

1

$weekly-report 今週のコミットから週報を作って

1

今週のgitコミットから週報を書いて