Практычныя прытамкі: ваш агент продовжае робіць тыя ж памылкі. Пачніце з яго.

У гэтым карыце парадокс з працэю агента, які постаўляе тыя ж памылкі, перадаёмся з сыр'ёў да рабочай системы. Пачніце з яго навыкаў. Акцэнт ставіцца на практычныя крокі, чыстае перакананне і код, які можна проста дадаць у репазітарый без неабязковасці з'ясоўваць мету. У стадзіі агульнага відгледу перш чым зменяць код, неабходна задаць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыёныя працавнікі должны магчымае перадзеяць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце гэтай стадзіі як даговору межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаць перакананні на успех і адмовіцеся ад тыхняй, непазначанай частковай завершэнні.

Часть агента, якую можна паспрабаваць падняць

Калі працуеце над «Частка сцэны», спачатку запісайце угоду: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Запісвайце час выканання і кост токена або запыту пад функцыйнальнымі рэзултатамі. Відразы коста з самага пачатку запобегае неспакоўным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўры. Зробіце перапаконтаванне пасля дорогіх крокаў. Функцыя адновлення не должна зноў нарахоўваць кост той самай вызову LLM, калі аператар прабуюць зноў запрацаваць пазнейшы вузел.

1. DRY: Зберагаеце роботу, якая вже успелася

Калі працуеце над этапам «1 DRY Save», спачатку запісайце умовы виконання: неабяжлівыя даны, сігнал успеху і тое, што выходзіць у разе частковага невыконання. Такі список дапамагае заліцвачыць змяны ў кодзе пазнейша. Храніце настройкі за межамі коду прыемліка. Файлы сераўнавання, храненні секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжлівага чытання всей структуры. Стварайце контрольныя пункты пасля дорогіх крокаў. Програма для продакцыі не должна занова ставіць плату за той самы вызов LLM, калі аператар перапрыяўляе выконанне на пазнейшы вузел.

2. Зробіце правыя навыкі простымі для выбору

Калі працуеце над стадзіяй «2. Зробіць правым», спачатку запісайце угоду: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некоректных паведамленняў ёсць частью продукту, а не пазнейшым дапрацоўкам. Стварайце контрольныя пункты пасля дорогіх крокаў. Система вярнення не должна зноў ставіць плату за той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел. Калі працуеце над стадзіяй «2. Зробіць правым», спачатку запісайце угоду: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага нявыпання. Такі список пераконвае ў тым, што пазнейшыя змены коду будуць чыстымі. Спрыймайце гэтую стадзію як угоду межа даннімі і перакананымі выходамі. Дайце назвы элементам, задаць критэрыя успеху і адмовіцеся ад тыхнага частковага завершэння без паведамлення.

383 skills scanned
  missing description           0
  no trigger language         306
  colliding pairs               3
  duplicate names              23
  skills with >=1 defect      306  (79%)

Дазвольце суседнім навыкам выканаць разныя задачы

Этап «Даўце суседзям навыкі» працюе наўпаклад калі яго спрыятаць як вимерную плошчу. Запісайце адны ідеальны прыклад, адзін прыклад неудачы і прыметку па адвярненню змян перш чым расширваць масштаб. Запісвайце часы выканання і кост токеноў або запытаў па боку функцыйнальных рэзультатаў. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы. Храніце стан графа простым і з аднаковым типам дадзеных. Вкладаныя блокі маскуюць, який вузел запісаў канкрэтны поле, і спакшваюць продаж чыннасці пасля перарываў.

name: vector-database-selection
description: >-
  Compare vector databases against workload, filtering,
  deployment, and operating-cost requirements. Use when
  choosing or replacing a vector store. For retrieval-pipeline
  design with an already chosen store, use rag-pipeline-design.

name: rag-pipeline-design
description: >-
  Design ingestion, chunking, retrieval, reranking, and
  evaluation for a RAG application. Use when building or
  diagnosing a retrieval pipeline. For a standalone vector
  database selection, use vector-database-selection.

3. Ператворыце дазнаўчасць у можна выкарыстоўваць інструкцыі

Метод «3 Turn Experience Into stage» работае наяўней, калі яго спрыяваць як мерыемую структуру. Запісаўце адна «золатая» транскрыпцыя, адзін прыклад неудачы і запіс пра вярненне да поперадньага стану, прычаму расшырваючы сферу дзеяння. Хавайце настройкі за межамі коду прыемлівання. Файлы сераўнавальнага сяродовішча, хранілішчы секрэтных дадзеных і флагі функций павінны знаходзіцца ў аднам месцы, куды аператары можаць адбавляць контроль без неабяжнага чытання всіх дадзеных. Хавайце стан графа простым і з адзінаковым типам дадзеных. Вкладаныя блокі дадзеных маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакоююць продажчыку роботы пасля перерываў.

Іноды Спяльны Кансультатывальнік Патрабуе Рэмонт

Этап «Sometimes the Shared Guide» працюе найкраща, калі яго спрыяваць як мерыемую паверхню. Зафіксавайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння. Дакументавайце як шлях успеху, так і шлях вярнэння да нормальнага стану. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадзецца дагэўна ў пазнейшы час. Храніце стан графаў у простам і типаваным формате. Вярнутыя структуры данных маскуюць інфармацыю пра тое, канфігурацыйны элемент запісаў які поле, і спакшуюць возз'яджанне пасля перарываў. Этап «Sometimes the Shared Guide» працюе найкраща, калі яго спрыяваць як мерыемую паверхню. Зафіксавайце адны ідеальны прыклад роботы, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць сферу дзеяння. Спрыявайце гэтам этапу як кантракту межа вхіднымі даннымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, задаць критэрыя успеху і адмовіцеся ад мовчанкавага частковага завершэння.

4. Пераканайцеся перш чым перадаць

Для стадіі «Пераканацьце пры выконанні» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры зміне коду. Аперацыйныя працавнікі павінны магчымае перазваляць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісваць час выконання і вартасць токена або запыту праза функцыйнальныя рэзултаты. Відразлівасць вартасцей з самага пачатку запобегае неспакоўным рахункам, калі процес пераходзіць з дэмовай среды ў спакульнаныя сераўеры. Заставіць людзкую апрацоўку для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны ў працэсе виробніцтва. Працэс складання коду не ўзначае абоўсюднай завершанасці бізнес-процэсаў.

Што змяніў аудытар у тэставанні

У стадії «Як тэставаць аудытар» неабяжна практычна вказаць інпуты, адпавядающага за крок адпаведальнага, а таксама критэрыі завершэння пры змяне коду. Аперацыйныя працавнікі павінны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы прыхованы стан. Конфігурацыю трэба знаходзіць за межамі коду прыемленае. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцый павінны быць у адном месца, якое аперацыйныя працавнікі могу пераглядаць, не чытаючы весь ланцуг. Пры змяніх, якія коштуюць грошы або зменяюць данні ў працэйным режыме, неабяжна выкарыстоўваць людскія затверджэння. Падключэння ў час компілявання не є прамаравам полнай адпаведнасці з бізнес-трэбованнямі.

Упакавка не паўзе. Навыкі — так.

Для стадіі «The Packaging Does Not» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтырыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія пераказы і обробка некоректных паведамленняў є часткай продукту, а не дадатковымі правакамі пазнейшае. Неабяжна адзначыць людскія затверджэння для тых крокоў, якія выкалічваюць грошы або зменяюць даны праработкі. Кампайляванне коду не ўзначае повнага адпрацоўкі бізнес-функцый. Для стадіі «The Packaging Does Not» неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крэтырыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Спрыяць гэтай стадіі як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даць назвы артыфактам, узначыць пераказы успеху і не прабаваць прыймать часткова завершаныя рэзультаты без падтверджэння.

Практыкуйце Whetstone на адзінай рабочай схеме

Калі працуеце на стадзіі «Практыкуйце Whetstone на адзінай», спачатку запісаце кантракт: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частыя неудачы. Такі список пераканаець заставляць вас быць чыстасаблівымі пад час будучых змен у кодзе. Запісвайце час выканання і кост токена або запытку пад час фіксавання функцыйнальных рэзультатаў. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі праця пераходзіць з дэмаверсіі ў спакульнаныя сераўсы. Зробіце контрольную пазнаку пасля дорогіх крокаў. Функцыя адновлення не должна зноў нарахоўваць косты той самай вызову LLM, калі аператар праканае пазнейшы вузел.

claude plugin marketplace add cdcore09/whetstone
claude plugin install whetstone@whetstone

python3 skills/skill-audit/scripts/audit_skills.py ./skills

Чэк-ліст для эксплуатацыі

Стадзія чэк-ліста для эксплуатацыі працюе лепш, калі яе спрыямаць як мерыемую плошчу. Запісаце адну ідеальную транскрыпцыю, адзін прыклад неудачы і прыметку па адкатаванні, перш чым расширваць масштаб.

Лепшыя маленькія, тэставаныя елементы, чым велікія скрыпты. Калі якісь крок не выйшае, адказка за гэта паталогія должна быць спрямована на адзін конкрэтны элемент, а не на заплутаны ланцюг задач.

Дзеянне графа трэба падтрымваць у простам і типаваным формате. Вярнутыя структуры дадзеных маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакоююць працу пасля перарываў.

Калі бюджет дазволяе, трэба дадаць тэст на першыя прабныя результаты, які працюе з критычным ланцюгам у процесе інтеграцыйных тэстаў за дапамогою фіксатывальных элементаў, а не з рэальнымі платнымі API.

Спрыяйце цэй стадзіі як даговору межа вхіднымі дадзеннямі і перакананымі выхіднымі рэзультатамі. Дайце назвы элементам, задаць критэрыя успеху і не прымайце часткова завершаныя рэзультаты без паведамлення.

Дзеянне графа трэба падтрымваць у простам і типаваным формате. Вярнутыя структуры дадзеных маскуюць інфармацыю пра тое, який вузел запісаў канкрэтны поле, і спакоююць працу пасля перарываў.

Перш чым запускать практыку, заморозьце версіі, зафіксавайце ідеальны транскрыпт для критычнага шляху і паказвайце способы анулювання змян. У спільных средах неабходны ліміты частоты запускаў, пераканання ў належнасці ресурсаў і чысткі власнік для змены секрэтных даных. Лепш выбіраць простую надзею на надзейнасць, чым хітрыя разовыя дэманстрацыі.

Прыметка для 89255a13dcea: не кладзіце ключы прадаўцаў у репазітарый, задаце верхнюю межу токену на кожную сесію і зберагачыце транскрыпты празаўсёды з фіксатрамі ацэнкі, каб пазнейшыя замены моделяў заставаліся порównаннімы.

Прыметка па забезпечэнню надзейнасці 0 стадыі работае лепш, калі яе спрыяваць як мерыемую плошчу. Зафіксавайце адны ідеальны транскрыпт, адзін кейс абыякавасці і прыметку анулювання перш чым расширваць масштаб. Дакументавайце як успішны, так і вярнучыся шляхы. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней.

Дзеянне паўжасткі 0/863: звярніце увагу на час выканання, класы паказакоў і витрату токенаў для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы робіць змены.

Для першага этапу паўжасткі неабходна ўзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчыма было перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Штодзе гэты этап трэба спрыяць як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Назвіце артыфакты, узначыце перакананні пра успех і адмовіцеся ад беззвучнага частковага завершэння.

Дзеянне паўжасткі 1/863: звярніце увагу на час выканання, класы паказакоў і витрату токенаў для гэтага зазначэння, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы робіць змены.

Калі працуеце над 2-м ўрадземліваннем, спачатку запісайце умовы кантракту: неабяжныя даны, сігнал успеху і тое, што выходзіць пад частым неудачам. Такі список дапамагае залічваць змяны ў кодзе чыста.

Канфігурацыю трэба зберагчы за межамі коду прыемленае. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аудыт без неабяжнага чытання всіх элементаў.

Дзял 2/863 ўрадземлівання: замерайце час выконання, класію каштоўкаў і выкарыстоўванне токенаў для гэтага пункту, а потым выберайце, чы робіць змяну на адной пазычанай базе пытанняў, а не на адной толькі прымітцы.

3-й ўрадземліванні лепей працуе, калі яго спрыямаць як меравальную плошчу. Запісайце адну ідеальную транскрыпцыю, адзін прыклад неудачы і прымітку па адвярненню роботы, прычым не расшырюючы сферу дзеяння.

Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неудача должна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок дзеянняў.

Дзеянне паўжырання 3/863: звярніце увагу на час выканання, класыя ошибак і колькасць токенаў, выкорыстаных для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацца застаўляць змяну.

Для 4-го этапа паўжырання неабходна перад змянай коду чытко визначыць вхідныя даны, адпаведальнага за этап і крэтырыя завершэння. Аперацыяныя працавнікі должны магчымае перадзваначыць гэты этап з вядомага пункта контролю, не прыпускаючы стану, які застаўся нез’явным. Запісывайце час выканання і колькасць токенаў або запытак праза функцыйнае рэзультат. Відкрытая інформацыя пра витраты запобегае неспакойным рахункам, калі працэс пераходзіць з дэмаверсіі ў спяльныя среды.

Дзеянне паўжырання 4/863: звярніце увагу на час выканання, класыя ошибак і колькасць токенаў, выкорыстаных для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацца застаўляць змяну.

Калі працуеце над 5-м падземам прыемкі забезпечэння безпекі, спачатку запісайце угоду: неабяжлівыя данні, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі список пераканае ў тым, што пазнейшыя змены коду будуць чыстымі.

Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некоректных паведамленняў є часткай продукту, а не пазнейшым дапрацоўкам.

Дзялёвая прыемка 5/863 забезпечэння безпекі: вымерайце час выканання, класыя ошибакі і витрату токенав для гэтай прыемкі, а потым выберайце, чы робіць змены на адной фіксаванай сэтке пытанняў, а не на адной лічбе прыкладаў.

5-й падзем прыемкі забезпечэння безпекі работае лепей, калі яго спрыямаць як вымеральную паверхню. Зафіксуйце адна ідеальная транскрыпцыя, адзін прыклад неудачы і запіску пра вярненне да пачатковага стану перш чым расширваце сферу дзейснення.

Спрыяйце гэтаму падзему як угоды межа даннімі і перакананымі выходамі. Дайце назвы артыфактам, задаце перакананні на успех і адмовіцеся ад тыхоўскага частковага завершэння.

Дзеянне паўжырання 6/863: зважыце час выканання, класію адказаў і колькасць токенаў, выкорыстаных для гэтага запісу, а пасля, на аднойчынныя крэтыры, а не на індывідуальных прыкладах, выявіце, чы робіць змены.

Для 7-го этапу паўжырання неабходна перад змянай коду адзначыць вхідныя даны, адпаведальнага за крок і крэтыры завершэння. Аперацыяныя працавнікі павінны магчымае перадзванаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Канфігурацыю трэба залічыць праз аплявацыйны код. Файлы сяродавішча, хранільнікі секрэтных дадзеных і флагі функцыйяў павінны знаходзіцца ў адном месцы, якое працавнікі можуць пераглядаць, не чытаючы весь граф.

Дзеянне паўжырання 7/863: зважыце час выканання, класію адказаў і колькасць токенаў, выкорыстаных для гэтага запісу, а пасля, на аднойчынныя крэтыры, а не на індывідуальных прыкладах, выявіце, чы робіць змены.

Калі працуеце над 8-м стадзіям заўважэння па забезпечэнню безпекі, спачатку запісайце умовы кантракту: неабяжныя даны, сігнал успеху і тое, што выходзіць па частковай нявыполненасці. Такі список контроля дапамагае залічыць пазнейшыя змены ў кодзе адкрыта і прозрачна. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына нявыполненасці павінна вказываць на адную адпаведальнасць, а не на заплутаны ланцюг задач.

Дзеянне 8/863 па забезпечэнню безпекі: замерайце час выканання, класы каштоўкаў і витраты токенав для гэтага заўважэння, а пасля, на аднойчынных крітэрыях, а не на індывідуальных прыкладах, выберайце, чы робіць змены.

8-я стадзія заўважэння па забезпечэнню безпекі працуе лепей, калі яе спрыямаць як меравальную плошчу. Запісайце адны ідеальны прыклад роботы, адзін кейс нявыполненасці і заўважэння па атрыбуцыі да пачатку, перш чым расширваць сферу дзеяння. Запісвайце часы выканання і вартасць токенав або запытак разам з функцыйнальнымі рэзултатамі. Відразувыя даны пра вартасці запобегаюць неспакойным рашчыткам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.

Дзеянне паўжчання 9/863: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы робіць змены.

Для 10-го этапу паўжчання неабходна перад змянай коду чытко визначыць вхідныя даны, адпаведальнага за этап і крэтыяры завершэння. Аперацыйныя працавнікі должны магчымае перадзвануць гэты этап з вядомага пункта контролю, не прыпускаючы стану, які залишаецца незрозумелым. Неабходна адначасова задокументаваць шлях успеху і шлях вярнення да нормальнага стану. Практыка павторных спроб, людзкія перакрыцця і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней.

Дзеянне паўжчання 10/863: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы робіць змены.

Калі працуеце над стадзіяй 11 з адаптавання, спачатку запісайце контракт: неабяжлівыя даны, сигнал успеху і тое, што выходзіць у разе частковага неяксаменства. Такій чарт дапамагае залічваць будучыя змены коду адкрыта. Спрэтавайце гэтую стадзію як контракт межа данымі і перакананымі выходамі. Дайце назвы элементам, задаце критэрыі успеху і не падзельвайцеся на частковыя завершэння без паведамлення.

Дзеянні адаптавання 11/863: звярніце увагу на час выканання, класы каштоўкаў і витрату токенав для гэтага пункту, а потым выберіце, чы робіць змену на адной пазначанай базе пытанняў, а не на адной лічбе прыкладаў.

Стадзія 12 з адаптавання працюе лепей, калі яе спрэтаваць як меруючую плошчу. Запісайце адны ідеальны прыклад роботы, адзін кейс неяксаменства і прыказку па адвярнэнню перад расшырэнням масштабаў. Зберагайце настройкі праз аддзел ад коду прыемлівача. Файлы сяродавішча, хранілішчы секрэтных дадзенняў і флагі функций павінны знаходзіцца ў адном месцы, якое аператары можаць пераглядаць без неабяжлівага чытання всей структуры.

Дэталі зміцнення 12/863: звярніце увагу на час выканання, клас памялкі і колькасць токенавытрачання для гэтай змянкі, а пасля, на аднойчынку з фіксаваным наборам пытанняў, а не на анекдотах, выявіце, чы хацеце застаўіць гэтую змяну.