Landing: 進化技能
將原始反饋轉化為經過驗證的規則。**沒有測試的規則會變成教條。**違反文字就是違反精神。
鐵律
沒有證據和範圍就沒有規則。
沒有會失敗的測試就沒有技能編輯。
必要背景: 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)中尋找相同教訓,並閱讀條目。缺陷或可測量結果的證據比偏好更重要。假設不計入。 - 按矩陣分類:
| 情況 | 目的地 |
|---|---|
| 重複且可通用 | 候選通用規則 |
| 重複但依賴環境 | 帶標籤的規則(aplica_quando) |
| 罕見但有高影響(秘密暴露) | 安全規則,即使只有一次發生 |
| 主觀且未經確認 | 保持為假設 |
| 無益處或已被腳本涵蓋 | 不提升 |
- 新規則: 編號
R-nnn、真實證據(cliente/E<nn>)、範圍、封閉詞彙的aplica_quando、nao_se_aplica_quando、移除條件、檢查(kit 腳本或無)以及負責技能。 - 如果規則修改某技能: 在
_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 開始,產生 v1 的 _regras-vivas.md 和 _evolucao.md。僅當有可測量的標準(大小、檢索失敗、具有體積的類別)時,才將檔案分割到 _regras-vivas/ 目錄中。
紅旗:停止
- "只發生過一次,就變成通用規則"(安全例外)
- "這很明顯,跳過測試" · 偽造證據或沒有真實
E<nn> - 將來自某個客戶的規則提升為全域規則 · 添加而不修剪
| 合理化 | 現實 |
|---|---|
| "Felipe 喜歡,所以是規則" | 未經確認的偏好保持為有範圍的假設 |
| "只是技能中的一行" | 沒有 RED 的編輯就是違反 TDD |
| "兩次發生就夠了" | 頻率是優先級,不是標準:評估適用性和風險 |
| "越多規則,越安全" | 規則太多變成噪音;修剪是工作的一部分 |