Галоўная / Артыкулы / Практычныя прытамкі: Я створыў Monster CLAUDE.md, і мой агент для кодавання стаў прыгожым і страшным.

Практычныя прытамкі: Я створыў Monster CLAUDE.md, і мой агент для кодавання стаў прыгожым і страшным.

Практычныя прыказкі: Я створыў Monster CLAUDE.md, і мой агент для кодавання парадзіў надзвычайна эфектываў: контракты, перакрыцця і слоты для коду для команд, якія викорыстоўваюць гэты патэрн.

1752 слоў

Наступныя прытамкі восстанавляюць практычны шлях для рэалізацыі проекту, адпраўленага да тэмы «Я створыў монстра CLAUDE.md, і мой кодавальны агент стаў надзвычайна скарожным». Акцэнт ставіцца на контракты, перакананняя і месцы для падставлення коду, а не на мотывацыйныя элементы. Калі працуеце на стадіі агледжэння, спачатку запісайце контракт: неабходныя даны, сігнал успеху і тое, што вядзецца ў разы частковай нявыполнення. Такі список перакананняя дапамагае заліцьваты пазнейшыя змены ў кодзе. Документавайце як шлях успеху, так і шлях вярнення да нормы. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў є частью продукту, а не элементамі пазнейшай дапрацоўкі.

Файл — гэта проста контекст, а контекст — гэта весь гэйм

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

Чатыры правілы, якія запобегаюць згадкам

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

Частка, якая насправды выканае работу: крэасунг

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

Дзе берэцца файл: gstack

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

Доказ: як гэта памагла мне перамогчы QuaRot

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

Чыстыя абазрэнні

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

Што насправды трэба взяць з гэтаго

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

Справакі

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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