Tumia sepia Kuandika, Kukagua na Kuboresha Maandishi ya Kibinadamu Zaidi

Sepia ni nini?

sepia ni Agent Skill inayoweza kubebeka kwa kuboresha hadithi za kubuni na nathari ya kitaalamu inayosaidiwa na AI. Inafanya kazi na Claude Code, Codex, Grok Build na Antigravity kwa kutumia SKILL.md moja ya msingi, hivyo kuepuka maelekezo tofauti kwa kila jukwaa.

Tofauti na zana zinazolenga msamiati na muundo wa sentensi, sepia huanza na mifumo ya kimuundo inayoweza kufanya maandishi yaonekane yametengenezwa na mashine. Kwa hadithi za kubuni, hiyo inajumuisha minyororo ya sababu na matokeo iliyo nadhifu kupita kiasi, mada zinazoelezwa na msimulizi, wakati unaosonga kwa mstari mmoja, uwakilishi mdogo wa hisia, kutokuwepo kwa marejeo ya ulimwengu halisi, na miisho inayotatuliwa kabisa kupitia kukua au kukubali hali.

Kwa hati za kitaalamu, sepia hutafuta matatizo tofauti: maneno ya kujaza yasiyo na taarifa, matumizi ya tahadhari yasiyo ya lazima, mabaki ya chatbot, mtindo usiofaa, muundo unaojirudia, na kushindwa kutimiza matarajio ya mahali hati itakapochapishwa au kutumiwa.

Kanuni kuu: elekeza uandishi kuelekea mgawanyo wa kawaida wa maandishi ya binadamu badala ya kubadilisha kimakanika kila mwelekeo unaodhaniwa kuwa wa AI.

Sifa kuu

Shughuli nne za uandishi

sepia hutoa shughuli nne zinazofaa kwa hatua tofauti za rasimu:

• write: Unda nathari mpya kwa kutumia kanuni husika za hadithi za kubuni au uandishi wa kitaalamu.
• review: Tambua matatizo bila kuhariri maandishi.
• refactor: Fanya marekebisho madogo na yaliyolenga huku ukihifadhi sehemu kubwa iwezekanavyo ya rasimu.
• recreate: Andika upya nyenzo yote wakati marekebisho ya sehemu moja hayatoshi.

Itifaki ya hatua tatu kwa hadithi za kubuni

1. Muundo wa simulizi: Shughulikia maelezo ya mada, usafi wa mfuatano wa sababu na matokeo, muda wa kufichua mambo, miundo ya hisia, mitandao ya wahusika, na marejeo ya vitu halisi.
2. Mtiririko wa usemi: Vunja violezo vinavyojirudia vya aya na maswali, rekebisha kudorora kwa simulizi katikati, na badilisha mdundo pamoja na uwekaji wa taarifa.
3. Mtindo wa juu juu: Rekebisha misemo iliyotumika kupita kiasi, violezo vya sintaksia, msamiati na rejesta baada ya kushughulikia matatizo makubwa ya kimuundo.

Skill hii pia inajumuisha rubriki ya uchunguzi wa hadithi za kubuni yenye vipengele 30 na marekebisho ya mifumo inayohusishwa na Claude, GPT, Gemini, DeepSeek na Kimi.

Kanuni za hati za kitaalamu

Nathari ya kitaalamu hutumia orodha ya pamoja ya ukaguzi pamoja na faili fupi ya kanuni kwa kila mahali panapoungwa mkono:

• Maelezo ya toleo na matangazo: Weka athari kwa mtumiaji kwanza, tegemeza madai kwa vielelezo, na epuka kutia chumvi kwa uuzaji.
• Majibu ya pull request na issue: Jibu kwanza, nukuu file:line, epuka sifa za mazoea, na linganisha urefu na uzito wa suala.
• Ripoti za baada ya tukio: Usilaumu watu huku ukichunguza mifumo kwa ukali; jumuisha mihuri ya muda, njia zilizokufa na vipengele vya utekelezaji vilivyopewa wamiliki.
• Tickets na maagizo ya kazi: Eleza matokeo katika kichwa, toa vigezo vya kukubalika vinavyoweza kujaribiwa, na weka kiungo badala ya kurudia taarifa.
• Makala za kiufundi: Anza na tatizo, jumuisha njia moja halisi iliyoshindikana na maoni moja yaliyothibitishwa, na weka masharti ya nambari pamoja na muktadha wake.

Sakinisha sepia

Wigo chaguo-msingi wa usakinishaji ni akaunti ya mtumiaji, hivyo usakinishaji mmoja unaweza kutumika katika miradi yote. Chagua maelekezo ya jukwaa lako la wakala.

Claude Code

# install
claude plugin marketplace add Nanako0129/sepia
claude plugin install sepia@sepia --scope user

# update
claude plugin marketplace update sepia
claude plugin update sepia

Ukisakinisha kupitia dirisha la programu-jalizi la Claude Code lililo ndani ya kipindi, chagua User unapoombwa wigo.

Codex

# install
codex plugin marketplace add Nanako0129/sepia
codex plugin add sepia@sepia

# update
codex plugin marketplace upgrade sepia
codex plugin add sepia@sepia

Kusasisha Codex kunahitaji kuonyesha upya nakala ya soko na kuongeza programu-jalizi tena ili kupata toleo jipya.

Grok Build

# install
grok plugin install Nanako0129/sepia --trust

# update
grok plugin update

Grok Build pia inaweza kugundua kiotomatiki usakinishaji uliopo wa sepia wa Claude Code.

Antigravity

Antigravity haitumii soko kwa skill hii. Nakili hazina, nakili saraka ya skill, na sakinisha mtiririko wa kazi wa kimataifa wa /sepia:

# install
git clone https://github.com/Nanako0129/sepia.git ~/.sepia
mkdir -p ~/.gemini/config/skills ~/.gemini/antigravity/global_workflows
cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

# update
git -C ~/.sepia pull
rm -rf ~/.gemini/config/skills/sepia && cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

Sakinisha kwenye majukwaa yote manne

Hazina hutoa hati inayosakinisha sepia katika wigo wa mtumiaji kwa majukwaa yote manne yanayoungwa mkono:

curl -fsSL https://raw.githubusercontent.com/Nanako0129/sepia/main/install.sh | bash

Hati hiyo hunakili mradi kwenye ~/.sepia. Weka SEPIA_HOME ili kutumia eneo lingine. Kuendesha amri hiyo hiyo tena husasisha usakinishaji. Ili kukagua hati kabla ya kuiendesha, nakili hazina na uendeshe ./install.sh kutoka kwenye checkout.

Sakinisha kupitia Skills CLI

Skills CLI hutoa njia nyingine ya kutumia sepia na inasaidia mawakala zaidi ya 77:

npx skills add Nanako0129/sepia -g
npx skills update -g

Chaguo la -g huchagua wigo wa mtumiaji. Bila chaguo hilo, CLI hutumia wigo wa mradi kwa chaguo-msingi.

Matumizi ya msingi

Baada ya usakinishaji, mwombe wakala wako atumie sepia na ataje mojawapo ya shughuli zake nne. Mifano iliyo hapa chini inaonyesha jinsi ya kuandika ombi, si amri mahususi za shell za jukwaa.

Andika hati mpya

Tumia write unapoanzia kwenye muhtasari. Tambua jukwaa lengwa ili sepia iweze kuchagua kanuni sahihi.

Tumia shughuli ya write ya sepia kuandaa rasimu ya madokezo ya toleo kutokana na mabadiliko haya.
Weka athari kwa mtumiaji kwanza na uunge mkono kila dai kwa kielelezo halisi.

Kwa hadithi za kubuni, toa dhana kuu, vikwazo, na muundo unaokusudiwa bila kuamuru kila hatua ya kimuundo:

Tumia shughuli ya write ya sepia kuunda hadithi fupi kutokana na dhana hii.
Tumia itifaki ya hadithi za kubuni, lakini hifadhi utata na uepuke kueleza dhamira.

Changanua bila kubadilisha rasimu

Chagua review unapotaka upate matokeo ya uchunguzi kabla ya kuamua cha kurekebisha. Omba wazi uchanganuzi pekee ili rasimu asilia ibaki bila kuguswa.

Kagua hadithi hii kwa sepia. Changanua pekee; usiiandike upya.
Tanguliza muundo wa masimulizi, kisha mtiririko wa usemi na mtindo wa jumla.

Kwa hati ya kitaalamu, taja aina yake:

Kagua ripoti hii ya tukio baada ya tukio kwa sepia.
Kagua mihuri ya muda, njia zilizokwama, uchanganuzi wa utaratibu, na vipengele vya hatua vilivyokabidhiwa.
Usihariri rasimu.

Fanya mabadiliko machache

Tumia refactor wakati rasimu kimsingi iko sawa na inapaswa kuhifadhi sauti, ukweli, na mpangilio wake kadiri iwezekanavyo.

Fanyia makala hii ya kiufundi refactor kwa sepia kwa kutumia mabadiliko machache.
Hifadhi madai yake ya kiufundi na sauti yake huku ukiondoa maneno ya kujaza na kurekebisha kutolingana na jukwaa.

Andika upya kuanzia mwanzo

Tumia recreate wakati matatizo ya kimuundo hayawezi kurekebishwa vizuri kwa mabadiliko ya sehemu ndogo.

Andika upya tangazo hili la toleo kwa sepia.
Hifadhi ukweli wote uliothibitishwa, anza na athari kwa mtumiaji, na ondoa kutia chumvi kwa uuzaji.

Kwa kuwa uundaji upya ni uandishi kamili wa upya, taja ni ukweli, nukuu, marejeo, au vikwazo vipi vinavyopaswa kuhifadhiwa.

Chagua shughuli sahihi

• Chagua write unapokuwa na nyenzo chanzi au muhtasari lakini huna rasimu inayoweza kutumika.
• Chagua review unapohitaji uchanganuzi, mpango wa uhariri, au maoni ya pili bila mabadiliko.
• Chagua refactor wakati kuhifadhi rasimu iliyopo ni muhimu zaidi kuliko kupata muundo mpya kabisa.
• Chagua recreate wakati muundo, mpangilio, au rejesta ya rasimu haifai kimsingi.

Vidokezo vya kina

Usitumie kila kanuni ya hadithi za kubuni

sepia imeundwa kuchagua takriban hatua tatu hadi tano zenye manufaa kwa hadithi na kuacha nafasi katika maeneo mengine. Kutumia kila marekebisho kunaweza kubadilisha muundo mmoja unaotambulika na kuweka mwingine. Mwombe wakala atangulize matokeo yenye athari kubwa zaidi badala ya kuongeza idadi ya kanuni zilizotumika.

Kagua hadithi hii kwa sepia na utambue masuala matano yenye athari kubwa zaidi.
Fanyia refactor matatu bora pekee, ukihifadhi kasoro zisizo za bahati mbaya.

Fanya marekebisho kwa mpangilio wa kimuundo

Kwa hadithi za kubuni, epuka kung'arisha sentensi kabla ya kuweka sawa muundo wa masimulizi. Mfuatano bora ni kukagua muundo, kurekebisha mtiririko wa usemi, na kisha kurekebisha mtindo wa jumla. Hii huzuia ung'arishaji wa kiwango cha sentensi kutupiliwa mbali wakati wa marekebisho makubwa zaidi.

Toa jukwaa na ushahidi

Kanuni za uandishi wa kitaalamu hutegemea muktadha. Mwambie sepia ikiwa rasimu ni tiketi, jibu la ombi la kuvuta, ripoti ya tukio baada ya tukio, dokezo la toleo, au makala ya kiufundi. Jumuisha faili husika, marejeo ya mistari, mihuri ya muda, vigezo vya kukubali, viungo, vipimo, na masharti ili matokeo yabaki mahususi.

Fungamanisha sepia na mradi

Tumia upeo wa mradi wakati hazina inahitaji kuhifadhi nakala inayojulikana ya ujuzi. Wasilisha skills/sepia/ kama .agents/skills/sepia kwa Codex na Antigravity, au kama .claude/skills/sepia kwa Claude Code.

Mbinu hii ni muhimu wakati timu inataka hazina ibebe toleo lake la ujuzi badala ya kutegemea usakinishaji wa kila mchangiaji katika upeo wa mtumiaji.

Kagua tabaka za marejeo

Ujuzi wa kikanoni uko katika skills/sepia/SKILL.md. Faili zake za marejeo zinatenganisha muundo wa masimulizi, mtiririko wa usemi, mtindo wa jumla, uchanganuzi, alama za mifumo ya miundo, kanuni za pamoja za kitaalamu, na nyanja mahususi za majukwaa. Saraka ya research/ ina msingi wa ushahidi uliosagwa wa mradi na viungo vya vyanzo.

Weka usakinishaji katika hali ya sasa

Tumia amri za kusasisha za jukwaa ulilochagua. Ikiwa ulisakinisha majukwaa yote kwa install.sh, endesha tena amri ileile ya usakinishaji. Usanidi wa mikono wa Antigravity unahitaji kuvuta hazina na kunakili tena faili zilizosasishwa za ujuzi na mtiririko wa kazi.

Hitimisho

sepia inaona uandishi unaosikika kama wa binadamu kuwa zaidi ya tatizo la msamiati. Mtiririko wake wa hadithi za kubuni huanza na muundo wa masimulizi, hupitia mtiririko wa usemi, na kuishia kwenye mtindo wa jumla, huku kanuni zake za uandishi wa kitaalamu zikibadilika kulingana na matarajio ya aina mahususi za hati. Isakinishe katika upeo wa mtumiaji au mradi, chagua shughuli inayolingana na lengo lako la uhariri, na tumia idadi ndogo ya mabadiliko yenye athari kubwa badala ya kila kanuni inayopatikana.

sepia imetolewa chini ya Leseni ya MIT. Chanzo chake, faili za marejeo, hati ya usakinishaji, na muhtasari wa utafiti vinapatikana katika hazina ya GitHub.