Landing: スキルの進化
生のフィードバックを検証済みのルールに変換します。テストのないルールは教義になります。 文字に反することは精神に反することです。
Iron Law
証拠とスコープのないルールは禁止。
事前に失敗するテストなしでのスキル編集は禁止。
必須バックグラウンド: superpowers:writing-skills(サブエージェントを使用した高圧シナリオ、RED、GREEN、REFACTOR)。
ゲート関数
- 一覧表示:
node kit/processar-feedback.js listar(kit =~/.claude/skills/criar-landing-page/assets/kit)。スコープとカテゴリごとにグループ化します。 - 並列調査: 各教訓について、他のクライアントでも同じものを見つけ(
grep -nを02と05-aprendizados.mdで実行)、エントリを読みます。defeitoまたはresultado-medidoの証拠はpreferenciaよりも重みがあります。仮説はカウントしません。 - 分類 マトリックスに従って:
| 状況 | 行き先 |
|---|---|
| 繰り返し発生し、一般化可能 | 一般ルールの候補 |
| 繰り返し発生するが、環境に依存 | タグ付きルール (aplica_quando) |
| まれだが影響大(秘密の漏洩) | セキュリティルール(1回でも) |
| 主観的、確認なし | 仮説のまま |
| メリットなし、またはスクリプトでカバー済み | 昇格しない |
- 新しいルール: id
R-nnn、実際の証拠(cliente/E<nn>)、スコープ、aplica_quando(限定語彙から)、nao_se_aplica_quando、削除基準、チェック方法(kit のスクリプトまたはnenhuma)、担当スキル。 - ルールがスキルを変更する場合: シナリオを
_testes-skills/cenarios/に書き、変更なしで実行(RED、合理化を記録)、編集し、変更ありで実行(GREEN)、抜け穴を塞ぎます(REFACTOR)。RED なしの場合は編集を削除します。 - 必須の剪定: 冗長なルール、スキル間で重複しているルール、またはスクリプトでカバーされているルールを削除または統合します。再設計は追加のみではありません。
node _testes-skills/lint-skill.mjs <skill>を前後で実行します(単語数)。 - 検証:
node kit/check-regras.js --file ~/projetos/criar-site/_regras-vivas.mdと、架空のクライアントのタグによる選択テストを実行します。 - クローズ:
node kit/processar-feedback.js marcar --versao v<N>を実行し、_evolucao.mdに記録します: 変更点、削除したもの、メトリクス(再オープンされた承認、カテゴリ別エラー、回帰、誤検出、Felipe が記録を思い出した回数)。
移行モード: すべてのエントリが processado: não の状態で同じプロセスを実行し、05-aprendizados.md から開始し、_regras-vivas.md v1 と _evolucao.md を生成します。ファイルは測定可能な基準(サイズ、検索失敗、カテゴリ別ボリューム)に基づいてのみ _regras-vivas/ に分割します。
レッドフラグ: 停止
- 「1回発生したので一般ルールにする」(セキュリティを除く)
- 「明らかなのでテストをスキップする」 · 証拠の捏造、または実際の
E<nn>なし - 単一クライアントのルールをグローバルに昇格させる · 剪定せずに追加する
| 合理化 | 現実 |
|---|---|
| 「Felipe が気に入っているのでルールにする」 | 確認なしの好みは、スコープ付きの仮説のまま |
| 「スキルに一行追加するだけ」 | RED なしの編集は TDD 違反と同じ |
| 「2回発生すれば十分」 | 頻度は優先度であり、基準ではない: 適用可能性とリスクを評価する |
| 「ルールが多ければ安全」 | ルールが多すぎるとノイズになる; 剪定は作業の一部 |