Tutorial 3 Your First Agent Task is

Kennsla 3 · Fyrsta verkefnið þitt með aðstoðarmanninum

🌎 Tungumál: Íslenska — sjá öll 33 tungumálin

Markmið: bæta glænýrri skipun við CLI-ið — frá enda til enda — með því að stýra aðstoðarmanninum þínum. Við bætum við lockedin endorse: hún staðfestir hæfni algerra ókunnugra á sviðum sem þau hafa nær örugglega ekki. Beint í anda verkefnisins.

Þetta er hjartað í kennsluefninu. Þú æfir raunverulegu lykkjuna: kröfulýsing → próf → útfærsla → hliðið grænt → yfirferð.

← Fyrra: Kennsla 2 Hvernig kóðinn virkar · Næst: Kennsla 4 Fyrirmæli og yfirferð

---

Skref 0 — Ákveddu hvernig „tilbúið“ lítur út

Áður en þú skrifar nokkur fyrirmæli skaltu setja kröfulýsinguna niður með skýru, einföldu máli. Loðnar beiðnir skila loðnum kóða — frá manneskju eða aðstoðarmanni.

endorse prentar 5–7 línur, hver um sig staðfestir hæfni handahófsvalinnar manneskju (endurnýttu núverandi NAMES-pool) fyrir handahófsvalda tískuorða-hæfni (nýtt pool). Hún endar á ádeilukenndri einlínu. Skipunin þarf að vera aðgengileg sem lockedin endorse, sem /endorse inni í lotu og að birtast í help. Öll slembni verður að nota seeduðu pick/shuffle hjálparföllin svo úttakið haldist endurtekningarhæft. npm test verður að vera áfram grænt og nýtt próf þarf að negla niður að minnsta kosti eina ófrávíkjanlega reglu.

Þessi málsgrein er það sem þú afhendir aðstoðarmanninum. Taktu eftir því að hún nefnir skorðurnar úr Kennslu 2 (seeduð slembni, prófunarhliðið og vanann um ófrávíkjanlegar reglur).

Skref 1 — Biddu um áætlun, ekki kóða

Byrjaðu á að biðja um áætlun. Þetta er tækifærið þitt til að stöðva slæma nálgun áður en nokkur skrá breytist.

„Mig langar að bæta endorse skipun við LockedIn CLI. Hér er kröfulýsingin: [paste your spec]. Áður en þú skrifar kóða, segðu mér hvaða skrám þú breytir og hvernig þú ætlar að fara að þessu, svo ég geti samþykkt það. Fylgdu núverandi mynstri fyrir skipun eins og connect.“

Góð áætlun nefnir: nýtt SKILLS-pool + renderEndorse() í src/lockedin.js, tengingu inn í dispatch() og handleSlash(), nýja röð í renderHelp(), útflutning á nýja fallinu/poolinu og próf í báðum prófaskrám. Ef áætlunin sleppir reglunni um seedaða slembni eða prófunum, segðu það strax.

Skref 2 — Próf fyrst

Biddu aðstoðarmanninn um að skrifa prófin á undan útfærslunni. Próf fyrst gera kröfulýsinguna að einhverju framkvæmanlegu og halda aðstoðarmanninum heiðarlegum.

„Frábært. Bættu fyrst bara við prófum sem eiga að falla: einingaprófi sem sannreynir að renderEndorse() skili texta sem nefnir þekkta hæfni og að minnsta kosti 5 staðfestingum, og prófi í cli.test.js sem sannreynir að lockedin endorse fari út með 0 og prenti staðfestingu. Notaðu fast seed. Ekki útfæra renderEndorse enn — við skulum fyrst sjá prófin falla.“

Keyrðu þau og fylgstu með þeim falla af réttu ástæðunni (fallið er ekki enn til):

npm test

Skref 3 — Leyfðu aðstoðarmanninum að útfæra þetta

Núna geturðu gefið grænt ljós á útfærsluna:

„Útfærðu þetta nú svo þessi próf fari í gegn, með því að fylgja mynstri connect. Bættu við SKILLS-pool með ~25 tískuorða-hæfnum, renderEndorse() sem skilar streng, tengdu við dispatch og handleSlash, bættu við röð í help og flyttu út það sem þú bættir við. Notaðu aðeins pick/shuffle fyrir slembnina.“

Það sem aðstoðarmaðurinn skilar ætti að líkjast restinni af skránni mjög. Til dæmis SKILLS-pool og render-fall:

const SKILLS = [
  'Hugsanaforysta', 'Samlegð', 'Stemning', 'Blockchain (hugmyndafræðilega)',
  'Auðmýkt', 'Að koma aftur að þessu', 'Árurækt', /* ...um 25 alls... */
];

function renderEndorse() {
  const people = shuffle(NAMES).slice(0, 5 + Math.floor(rand() * 3)); // 5–7
  const skills = shuffle(SKILLS);
  const out = [''];
  people.forEach((n, i) =>
    out.push('  ✔ Staðfesti ' + n + ' fyrir ' + skills[i % skills.length]));
  out.push('', '  Þú staðfestir hæfni 6 ókunnugra á sviðum sem þú getur ekki sannreynt. Þau munu staðfesta þína hæfni á móti innan klukkustundar.');
  return out.join('\n');
}

…ásamt einni línu í dispatch() og handleSlash(), röð í renderHelp() og SKILLS, renderEndorse bætt við module.exports.

Skref 4 — Hliðið

npm test

Grænt? Þú varst að senda frá þér eiginleika með aðstoðarmanni, próf fyrst. Ekki grænt? Það er eðlilegt — farðu í ítrunarhringinn í Kennslu 4 og segðu aðstoðarmanninum nákvæmlega hvað brást.

Skoðaðu síðan raunverulegu niðurstöðuna (próf athuga textann, en þú ættir samt að sjá hann):

node bin/lockedin.js endorse
LOCKEDIN_SEED=1 node bin/lockedin.js endorse   # endurtekningarhæft

Skref 5 — Farðu yfir áður en þú samþykkir

Samþykktu aldrei diff sem þú hefur ekki lesið. Flettu sérstaklega eftir þessu:

• Fór það eftir mynstrinu? Nýja skipunin ætti að spegla connect — engin ný háð, ekkert console.log inni í src/.
• Aðeins seedaða slembni? Leitaðu að Math.random í diffinu. Það ætti ekki að vera neitt.
• Snerti það eitthvað sem það átti ekki að snerta? Breytingin ætti að vera viðbót; ótengdar línur ættu ekki að færast til.
• Er nýja prófið merkingarbært? Það ætti að falla ef einhver brýtur eiginleikann síðar — ekki bara sannreyna true.

Ef eitthvað er ekki í lagi skaltu biðja um lagfæringu (Kennsla 4). Ef þetta lítur vel út er verkinu lokið.

---

✅ Prófaðu þetta með aðstoðarmanninum þínum

Farðu í gegnum alla lykkjuna hér að ofan í alvöru. Síðan, fyrir aukastig, skaltu biðja aðstoðarmanninn að lengja þetta:

• „Láttu endorse taka valkvætt nafn: lockedin endorse Ada ætti að staðfesta Ada sérstaklega. Bættu við prófi og haltu hliðinu grænu.“

Nú hefurðu byggt eiginleika frá enda til enda. Síðasti kaflinn snýst um að gera þetta lipurlega — skrifa fyrirmæli og fara yfir breytingar eins og leiðandi verkfræðingur.

Næst: Kennsla 4 Fyrirmæli og yfirferð