Jenga Mitiririko ya Kazi ya Usimbaji Inayopitishwa kwa Fable Orchestrator

Fable Inafanya Nini

Fable ni ujuzi mdogo wa kuelekeza unaotanguliza matumizi ya ndani kwa Codex. Inatenganisha upangaji na utekelezaji: Claude Fable 5.1 hupanga kazi na kufanya maamuzi ya usuluhishi, huku Codex ikiendelea kuwa mazingira ya utekelezaji, ikidhibiti eneo la kazi, na kukabidhi kazi za utekelezaji zenye mipaka kwa mawakala wa OpenCode Go.

Utekelezaji wa kawaida hukabidhiwa kwa GPT-5.6 Luna. Kazi zinazohusisha mizunguko, marudio ya utekelezaji, au utekelezaji wa kiwango cha juu hukabidhiwa kwa DeepSeek V4 Flash. Claude Fable 5.1 hubaki nje ya mtiririko wa utekelezaji na haiandiki msimbo wala kumiliki eneo la kazi.

Fable ni ujuzi wa kuratibu, si lango huru la modeli wala dashibodi ya uendelezaji.

Sifa Muhimu

• Uendeshaji unaotanguliza matumizi ya ndani: ujuzi husakinishwa katika saraka ya ndani ya ujuzi za Codex.
• Utenganishaji wazi wa majukumu: Fable hupanga na kufanya maamuzi ya usuluhishi, huku Codex ikitekeleza na kuthibitisha kazi.
• Ukabidhi wenye mipaka: nodi za utekelezaji hutumia tu njia zinazoruhusiwa za GPT-5.6 Luna au DeepSeek V4 Flash.
• Utekelezaji sambamba: Codex inaweza kuanzisha wafanyakazi walio tayari kwa wakati mmoja inapofaa.
• Uthibitishaji unaotegemea ushahidi: Codex hukusanya ushahidi wa wafanyakazi na kuthibitisha matokeo kabla ya kukamilisha mtiririko wa kazi.
• Uelekezaji wa kushindwa kwa usalama: ikiwa hakuna njia ya OpenCode Go iliyoruhusiwa inayoweza kuitwa, mtiririko huripoti kizuizi badala ya kutumia modeli isiyoidhinishwa.
• Usakinishaji salama na unaoweza kurudiwa: kisakinishi kinaunga mkono majaribio bila kutekeleza, maeneo lengwa maalum, na kunakili kusikozalisha mabadiliko yasiyo ya lazima.

Elewa Hazina

Hazina ina ujuzi unaoweza kusakinishwa, kisakinishi chake, majaribio, na rasilimali ya usanifu:

skill/fable/
├── SKILL.md
├── agents/openai.yaml
└── scripts/ask_fable.sh
assets/fable-orchestrator.svg
install.sh
tests/test_skill.sh

Faili tatu zilizo ndani ya skill/fable/ zinaunda ujuzi unaoweza kusakinishwa. Skripti ya ask_fable.sh inaweza kutekelezwa na huita lakabu ya ndani ya fable ya Claude Code bila kuhifadhi kipindi.

Mahitaji ya Awali

Kabla ya kusakinisha ujuzi, sanidi mawakala wa opencode-go/ na opencode-go-responses/ wanaoweza kuitwa kupitia Codex Router. Fable hutumia mawakala hao lakini haitoi proksi, dashibodi, katalogi ya modeli, hifadhi ya vitambulisho, au ufunguo wa API wake.

Anzisha upya Codex baada ya kubadilisha ufafanuzi wa watoa huduma au mawakala. Hii huhakikisha kuwa kazi mpya inaona usanidi wa sasa wa uelekezaji.

Sakinisha Fable

1. Hakiki usakinishaji

Ukiwa kwenye mzizi wa hazina, endesha kisakinishi katika hali ya majaribio bila kutekeleza:

./install.sh --dry-run

Hii huchapisha mahali lengwa na shughuli kamili za kunakili bila kuunda faili. Itumie kuthibitisha kitakachofanywa na kisakinishi kabla ya kufanya mabadiliko.

2. Sakinisha katika saraka chaguo-msingi

Copy ujuzi kwenye eneo chaguo-msingi la ujuzi za Codex:

./install.sh --copy

Mahali lengwa chaguo-msingi ni ~/.codex/skills/fable. Kisakinishi huunda saraka zinazohitajika tu na ni salama kuendeshwa mara kwa mara.

3. Chagua saraka maalum ya ujuzi

Tumia --target unapotaka kusakinisha mahali pengine badala ya eneo chaguo-msingi:

./install.sh --copy --target "$PWD/.local/codex/skills"

Kisakinishi husoma hazina na njia lengwa pekee. Hakisomi, hakiundi, wala hakibadilishi vitambulisho.

Matumizi ya Msingi

Anzisha kazi mpya ya Codex, kisha ita ujuzi kwa lengo:

$fable build the feature

Fable hujibu kwa grafu ya kazi yenye mipaka. Codex huthibitisha grafu hiyo, huanzisha wafanyakazi walio tayari kwa wakati mmoja inapofaa, hukusanya ushahidi wao, na kuthibitisha kazi iliyotokana. Ikiwa uamuzi mwingine wa upangaji unahitajika, Codex huomba Fable ifanye usuluhishi.

Jinsi uelekezaji unavyofanya kazi

1. Fable huchanganua lengo na kutoa mpango wenye mipaka.
2. Codex huthibitisha grafu iliyopendekezwa kabla ya utekelezaji.
3. Nodi za utekelezaji wa kawaida huelekezwa kwa GPT-5.6 Luna.
4. Nodi za utekelezaji zenye marudio mengi au kiwango cha juu huelekezwa kwa DeepSeek V4 Flash.
5. Codex hukusanya ushahidi na kuthibitisha matokeo ya mwisho.
6. Fable hushauriwa tena inapohitajika usuluhishi zaidi.

Kila nodi ya utekelezaji lazima itumie mojawapo ya njia mbili zinazoruhusiwa za OpenCode Go. Ikiwa hakuna inayopatikana, chukulia kizuizi kilichoripotiwa kuwa tatizo la usanidi badala ya kujaribu kukwepa sera ya uelekezaji.

Shughulikia Pakiti za Upangaji kwa Usalama

Pakiti inayopitishwa kwa ask_fable.sh inapaswa kuwa na maamuzi na ukweli wa eneo la kazi pekee. Usijumuishe kamwe vitambulisho, funguo za API, tokeni, au siri nyingine katika pakiti.

Kwa kuwa skripti huita lakabu ya ndani ya fable bila kuhifadhi kipindi, kila ombi linapaswa kujumuisha ukweli muhimu unaohitajika kwa hatua hiyo ya upangaji au usuluhishi.

Jaribu Usakinishaji

Endesha seti ya majaribio ya hazina isiyohitaji utegemezi mwingi kutoka kwenye mzizi wa hazina:

tests/test_skill.sh

Jaribio linahakiki:

• Faili chanzo zinazonakiliwa na kisakinishi.
• Kamba za uelekezaji zinazohitajika.
• Muundo msingi wa YAML.
• Uthibitishaji wa XML wa hiari kupitia xmllint.
• Vizuizi vya usalama vya SVG.
• Majaribio bila kutekeleza kwa kutumia saraka ya muda ya nyumbani.
• Operesheni ya kunakili isiyozalisha mabadiliko yasiyo ya lazima.
• Ukaguzi wa kamba za kawaida zinazoweza kuwa vitambulisho.

Jaribio halihitaji PyYAML wala kuingia kwa Claude moja kwa moja, hivyo linafaa kwa uthibitishaji mwepesi wa ndani.

Vidokezo vya Juu vya Uendeshaji

Thibitisha uelekezaji kabla ya kutatua hitilafu za ujuzi

Ikiwa Fable inaripoti kuwa hakuna njia ya utekelezaji iliyoruhusiwa inayoweza kuitwa, kwanza angalia ufafanuzi wa Codex Router wa opencode-go/ na opencode-go-responses/. Baada ya kubadilisha ufafanuzi wa watoa huduma au mawakala, anzisha upya Codex na uanze kazi mpya.

Tumia uendeshaji wa majaribio kwa usakinishaji maalum

Unaposakinisha kwenye saraka ya skills ya mradi au saraka isiyo ya kawaida, changanya --dry-run na --target kabla ya kunakili:

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

Hii hukuruhusu kukagua mahali pa kulengwa na shughuli za faili zilizopangwa kabla ya kurekebisha saraka iliyochaguliwa.

Rudia usakinishaji unaposasisha

Kwa kuwa operesheni ya kunakili inaweza kurudiwa bila madhara, unaweza kuiendesha tena kwa usalama unaposasisha skill iliyosakinishwa kutoka kwenye hazina. Baada ya kunakili, endesha tests/test_skill.sh ili kuthibitisha ukaguzi wa hazina.

Weka majukumu tofauti

Usimchukulie Fable kama mfanyakazi wa utekelezaji. Majukumu yake yaliyoandikwa ni kupanga na kufanya uamuzi wa mwisho. Codex huhifadhi udhibiti wa wakati wa utekelezaji, umiliki wa workspace, ugawaji wa kazi, ukusanyaji wa ushahidi na uthibitishaji.

Hitimisho

Fable hutoa njia iliyolenga ya kuongeza upangaji wenye mipaka na uelekezaji wa modeli kwenye Codex. Sanidi mawakala wa OpenCode Go, hakiki na unakili skill, iite kwa lengo lililo wazi, na utumie majaribio yaliyojumuishwa kuthibitisha usanidi. Weka vitambulisho vya kuingia nje ya pakiti za upangaji na anzisha upya Codex kila ufafanuzi wa uelekezaji unapobadilika.