1k-retrospective について
OneKey 向けに、事例を分析して繰り返し発生する不具合パターンに基づくセルフテスト規則の更新を提案するスキルです。規則の変更はユーザーの確認後に行います。
主な機能
- 01直近のマーカー以降の事例を分析
- 02原因を既存のチェック項目に対応付け
- 03繰り返す不足や弱いチェックを特定
- 04簡潔な規則更新案を提示
- 05アーカイブ済み事例を保持
活用シーン
- 01不具合事例に繰り返し現れる原因を確認
- 02不足しているセルフテスト項目を発見
- 03問題を見逃し続けるチェックを強化
- 04ユーザー承認用の規則変更案を準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ onekeyhq/ app-monorepo --skill 1k-retrospectiveインストール後、Claude Code で/1k-retrospectiveを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/case-studies.md
詳細
振り返り:実際の事例からセルフテストのルールを改善する
ワークフロー
ステップ 1:事例を読む
.claude/skills/1k-retrospective/references/case-studies.md を読みます。最後の `` マーカー以降の事例数を数えます。新しい事例が 3 件未満の場合は、「新しい事例が不足しています」と報告して終了します。
ステップ 2:パターンを分析する
各事例について、根本原因のカテゴリと、それを検出できた可能性のあるセルフテストのセクション(1~8)を抽出します。該当するセクションがない場合は「NEW」とします。パターンごとに件数を集計します。
ステップ 3:ギャップと弱点を特定する
- ギャップ:「NEW」とされたパターンが 2 回以上 発生している場合 → 新しいチェック項目の候補
- 弱点:すでに対象となっているパターンが 3 回以上 発生している場合 → チェック項目の表現を強めるか、具体性を高める必要があります
ステップ 4:変更を提案する
簡潔なレポートを出力します。
Retrospective — YYYY-MM-DD
Cases analyzed: N (date range: YYYY-MM-DD to YYYY-MM-DD)
Recurring patterns: [pattern] N (NEW/WEAK), [pattern] N (NEW/WEAK)
Proposed changes: Add [Section N] [one-line check] / Strengthen [Section N] [current → revised]
Housekeeping: archive candidates [list], zero-hit checks [list]
ステップ 5:変更を適用する(ユーザーの確認後)
self-testing.mdc を変更する際のルール:
- 最大 150 行 — 超える場合は、類似する項目をまとめるか、詳細を
references/patterns.mdに移します - チェック項目は 1 行のみ — ルールファイルにコード例を記載しません
- 9 セクション構成を維持する — 新しい項目は既存のセクションに追加し、新しいセクションは作りません
- 事例を削除しない —
[ARCHIVED]を先頭に付けてアーカイブ済みとします
ステップ 6:タイムスタンプを更新する
case-studies.md に追記します:
例
5 件の事例:BigNumber が 3 件(NaN/精度/除算)、クリーンアップが 1 件、古いクロージャーが 1 件。 → BigNumber = NEW(3 件)→ セクション 1 に 1 行のチェック項目を追加します。
コメント
Markdown 対応