impl
autoflow-kit で実装・変更・追加・修正を行う手順。「H1 の条件に〜を足して」「レビューの観点を足して」「取得元に Jira を足して」「プロファイルに項目を足して」「verify に引数を足して」「探索役のプロンプトを直して」「〜の不具合を直して」のような、この基盤のコード・ひな形・配布するスキルを書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- impl
- description
- autoflow-kit で実装・変更・追加・修正を行う手順。「H1 の条件に〜を足して」「レビューの観点を足して」「取得元に Jira を足して」「プロファイルに項目を足して」「verify に引数を足して」「探索役のプロンプトを直して」「〜の不具合を直して」のような、この基盤のコード・ひな形・配布するスキルを書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。
02 资源文件 1
- 参考文档references/patterns.md15.1 KB
03 SKILL.md 正文
autoflow-kit の実装手順
このスキルは次の資料と一緒に使う。パスは基盤のルートからの相対パスである。
docs/design/rules.md:ルールの全文。<接頭辞>-<番号>のルールIDで参照する.claude/skills/impl/references/patterns.md:パターンごとの手順と、作るファイルの一覧docs/design/architecture.md:依存の許可表(4章)と変更シナリオ表(7章)- 見本(参照実装):
kit/.autoflow/autoflow_kit/(全モジュール)、kit/.autoflow/templates/prompts/、tests/
既存のコードと rules.md が食い違ったら rules.md に従い、食い違いを報告に書く。
1. 依頼をパターンに振り分ける
| 依頼に含まれること | patterns.md の節 |
|---|---|
| H1(方向の確認)・H2(行き詰まり)を起こす条件、関所の選択肢 | 1 |
| リスクの段の決め方(パス、行数)、レビューの深さ・観点・投票の閾値 | 2 |
| 取得元(課題の管理の道具) | 3 |
| プロファイル(profile.json)の項目 | 4 |
| サブエージェントが書く JSON の項目、ひな形の置き換えの名前 | 5 |
| 既存のサブコマンドへの引数、既存の段の振る舞い | 6 |
| 新しい段・サブコマンド | 7 |
| プロンプトの文言、配布するスキルの手順、サブエージェントの定義 | 8 |
| 不具合の修正(振る舞いを変えずに直す) | 9 |
| 道具の版(ruff、mypy)を上げる | 実装しない。ADR を書いてから Makefile の RUFF・MYPY を変える(PROC-03) |
- 複数の行に当たる場合は、表の上から順に全部行う
- どの行にも当たらない場合は、実装しない。必要なパターンとルールを提案として報告する。見本に無い形をその場で発明すると、作者ごとに違う形が生まれるからである
2. 依頼から決まらない値
推測で決めない。聞ける状況ならユーザーに聞く。聞けない状況なら既定値で決め、報告の3に書く。
| 決めること | 何に響くか | 既定値 |
|---|---|---|
| 規則・観点・取得元・段の名前 | 定数、JSON、test_<名前> のメソッド名 |
依頼の語を英語の snake_case にした名前(取得元は小文字1語)。規則は判定の関数名(_is_<状態>・_has_<もの>)だけを決め、id はそこから _is_・_has_ を除いて h1_・h2_ を付ける(GATE-01。_is_human_only → h1_human_only) |
規則の文(PlanRule・ProgressRule の text) |
gates.md、関所の理由のファイル | 既存の規則と同じ「〜である」「〜した」で終わる1文 |
| プロファイルの新しい項目の既定値 | 既存の利用者の振る舞い | 今の振る舞いを変えない値。上限なら既存の上限と同じ桁 |
| 新しい観点を入れる深さ | 探索役の人数と費用 | deep だけに入れる |
| 取得元が課題の番号(ref)を要るか | start の検証 |
課題の番号のある道具なら要る(True) |
| JSON の新しい項目の型と、無いときの値 | ひな形の例、support.act_* |
文字列なら ""、一覧なら []。省略は許さず、必須の項目にする |
| 人に見せるエラーの文言 | 出力、テストの assert | 「<何が>…です。<次にすること>」の2文。次にすることは命令形で書く |
| 新しいサブコマンドの名前 | cli.HELP、status、スキルの表 |
<段>-new(プロンプトを書く)と <段>-check(出力を確かめる)の組か、動詞1語 |
| 新しいテストのメソッドを置く場所 | 差分の位置 | そのテストのクラスの最後 |
| プロンプトの一覧の1行を作る関数の名前 | 段のモジュールの関数名 | _<置き換えの名前>_line(prior_findings → _prior_findings_line、findings → _findings_line)。値を作る段のモジュールに置く |
3. 書く前に読む
-
patterns.md の該当する節を最後まで読む
-
rules.md のうち、パターンに対応する接頭辞の節をすべて読む
パターン 読む接頭辞 1、2 GATE、TEST、PROC 3、4、5、6 STATE、ERR、NAM、TEST、PROC 7 全部 8 STATE、GATE、OPS、STR 9 CODE、ERR、TEST -
見本の該当ファイルを開き、構成・命名・import の並び・コメントの書き方を確かめる
4. 作る順序
patterns.md の該当節の「作る・変えるファイル」の順に作る。段を足すときは PROC-01 の順(trail → contracts・layout → 段のモジュール → status → cli → テスト → autoflow/SKILL.md)に作る。
変えるのは、当たった節の「作る・変えるファイル」の表にあるファイルだけにする。表のモジュール(「項目を使う段のモジュール」のように行で名指ししたものを含む)を変えたら、そのテスト tests/test_<モジュール>.py も表にあるものとして扱い、変えた振る舞いを確かめる assert を足す。表に無いファイル(設計文書、README、他の段のモジュールなど)を変えたほうがよいと考えたら、変えずに報告の5に書く。表の外の変更は、作者ごとに入れるかどうかが分かれるからである。
各ファイルを保存するたびに、hooks が make fix-file を走らせる(TOOL-02)。指摘が出たら、次のファイルに進む前に直す。表(policy の表、profile.FIELDS)を変えたら make docs を回す。
5. 検証する
-
make checkを実行する -
落ちたら、エラーに出たルールIDか lint のルール名を rules.md で引き、コードを直す。lint のルール名とルールIDの対応は
docs/design/enforcement-matrix.mdにある -
次の方法で検査を黙らせない
- 検査の設定や保護ファイルを変える
- 抑止コメントを書く
- テストを skip する、または消す
どうしても直せない場合は、その状態のまま報告する
6. 完了前チェックリスト
該当するファイルを開き、1つずつ確かめる。
- [ ] PROC-02:rules.md の波及の対応表で、変えた左の列に対応する右の列を全部変えた(
policyの表 ⇔make docs、policy.LENSES⇔finder.mdの観点の節、contractsの項目 ⇔ ひな形の例とtests/support.py、profileのキー ⇔views.render_profileとsetup.py、layout.SOURCES⇔references/sources.md、trailの段 ⇔status.pyとautoflow/SKILL.md、モジュールの増減 ⇔structure_check.pyと architecture.md の許可表) - [ ] TEST-03:足した名前ごとに、rules.md の表の置き場に
test_<足した名前>を1つ足した。名前を足さない修正は、既存のメソッドに assert を足した - [ ] STATE-01:段の進み具合(何回目か、どの段か)を
trail.jsonl以外のファイルに書いていない - [ ] STATE-02:プロンプトの文をコードに書いていない。置き換えの値は生の値か
render.bullets・render.tableの結果だけ - [ ] NAM-02:関数名の先頭の動詞を rules.md の語彙表の意味で使った。真偽値を返す関数は
is_・has_で始めた - [ ] CODE-01:引数の
dict・listを変えていない(problemsを除く) - [ ] OPS-03:人に見せる文言は日本語で、表と数は
renderの関数で書いた - [ ] PROC-06:profile.json のキーを足す・消す・意味を変えたなら、
SCHEMA_VERSIONを上げ、ADR に移行の手順を書いた - [ ] TOOL-04:保護ファイルを変えていない(依頼で明示されたときを除く)
- [ ]
make checkが通った(PROC-05)
7. 報告する
次の順で書く。
- 何を作ったか(使ったパターン)
- 変えたファイルの一覧(作る順序の順)
- 2 で決めた値と、その根拠(依頼文、ユーザーの回答、既定値のどれか)
make checkの結果(出力の末尾)- 決めきれずに残したこと、ルールと既存コードの食い違い
04 同仓库更多 Skills
setup
このDocusaurusパターンの初期設定・設定変更を、OSSと独自設定の台帳に沿った質問とCLIで行う。site.settings.jsonとsetup/settings.catalog.jsonがある配布先で使用する。
sample
日付の表記を ISO 8601(YYYY-MM-DD)にそろえる見本のスキル。テストで使う。
skill-tune
既存の Claude Code スキルを評価データで改善する。正解データがあれば学習用・検証用・テスト用に分け、無ければ人と評価項目を決め、独立した学習と検証のラウンドを回し、最後にテスト用で測って報告する。
review
skill-tune-kit の変更をレビューする手順。差分、プルリクエスト、ブランチ、特定のファイルのレビューを頼まれたとき、また「この実装で問題ないか確認して」「ルールに沿っているか見て」と頼まれたときは必ず使う。機械の検査を先に回し、機械で拾えないルールをルールIDごとに確かめ、固定の形式で指摘と判定を返す。
impl
skill-tune-kit で実装・変更・追加・修正を行う手順。「検査の種類を足して」「サブコマンドを追加して」「プロンプトの文言を直して」「plan.json に項目を足して」「status の表示を変えて」「採否の規則を変えて」「〜の不具合を直して」「skill-tune の手順を直して」などの依頼で使う。この基盤のコードや配布物を書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。
sample
議事録の日付をそろえる。議事録の整形を頼まれたときに使う。