Agent-almanac chrysopoeia
install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/wenyan/skills/chrysopoeia" ~/.claude/skills/pjt222-agent-almanac-chrysopoeia-b045b8 && rm -rf "$T"
manifest:
i18n/wenyan/skills/chrysopoeia/SKILL.mdsource content
點金術
自現存之碼中取至大之值——識何為金(值高、設善),何為鉛(耗重、拙劣),何為渣(死重)。後揚金、化鉛、除渣。
用時
- 優行運之遲碼為速
- 磨 API 之面已積冗者
- 減包量、記憶、啟時
- 備碼為開源(取其值核)
- 碼行而不輝——宜磨,非重書
入
- 必:待優之庫或模(路徑)
- 必:值量之度(性能、API 清晰、包量、可讀)
- 可選:剖析之資料或基準示當前之能
- 可選:目標(如「減包四成」、「百毫秒內應」)
- 可選:制(不可變公 API、須容舊)
法
第一步:驗——分其材
逐元分其值之獻。
- 定量度於入(性能、清、量等)
- 點碼庫諸元(函、模、出、依)
- 分每元:
值之分類: +--------+---------------------------------------------------------+ | 金 | 值高設善。揚而護之。 | | 銀 | 值善微瑕。磨之。 | | 鉛 | 可行而重——能拙、API 雜。化之為輕。 | | 渣 | 死碼、未用之出、殘餘之功。盡除之。 | +--------+---------------------------------------------------------+
- 性能之優,先剖:
- 識熱徑(時所耗處)
- 識冷徑(罕行之碼或為渣)
- 量記憶分配之式
- 生驗冊:元元分類附證
得: 諸顯元皆分附證。金元已識以護於優時。鉛元依影響列。
敗則: 若剖具不可得,以靜析:函複度(環路)、依量、碼量為代。若庫過大,先專危徑。
第二步:煉——揚其金
護且增至值之元。
- 每金元:
- 確其有全測(此汝至貴之產)
- 若未然則明書其界面
- 慎思可否抽為可再用之模
- 每銀元:
- 施針對之改(善名、清型、微優)
- 增測覆至金級
- 解微碼臭而不重構
- 勿改金銀之行——只增其磨與護
得: 金銀已善測、善書、善護。無行之變,只質之增。
敗則: 若「金」元於近察露隱患,重分之。誠於值勝於護瑕。
第三步:化——鉛成金
化重拙之元為優等。
- 鉛元依影響列(耗資最多者先)
- 每鉛元擇化之策:
- 算法之優:以 O(n log n) 代 O(n^2),除冗算
- 緩存/記憶:存屢求之貴果
- 惰算:延算至果確需
- 批處:合多小作為少大作
- 結構之簡:減環路之複,平深嵌
- 施策而量其改:
- 前後之基準於性能
- 前後之行數於複度
- 前後之依數於耦合
- 化畢驗其行之等
得: 於目量有可量之改。每化元勝於鉛前而行等。
敗則: 若鉛元拒優於其當前界面,察界面本為患。或化需變呼之法,非只變實之法。
第四步:去——除其渣
系除死重。
- 每渣元驗其確未用:
- 搜所有引(grep、IDE 用處查)
- 察動引(以字分派、反射)
- 察外用(若碼為庫)
- 除已證之渣:
- 刪死碼、未用之出、殘餘之功
- 自包單中除未用之依
- 清已除功之設
- 每除驗無破(行測)
- 書所除者及其由(於提交之訊,非於碼)
得: 庫更輕。包量、依數、碼量可量之減。諸測仍通。
敗則: 若除元而破某物,非渣也——重分之。若動引礙驗用,除前加暫誌以確無行時之訪。
第五步:驗——稱其金
量總之改。
- 行第一步之基準
- 比前後於目量
- 書點金之果:
- 已煉之元(金銀之改)
- 已化之元(鉛→金附量)
- 已除之元(渣附量/數之影)
- 總量之改(如「快四成七」、「包減三成二」)
得: 於目量有可量、有書之改。庫可證更值於前。
敗則: 若總改微,原碼或勝於所料。書所學——知碼已近優本身即值。
驗
- 驗冊分諸顯元附證
- 金元有全測與書
- 鉛化示可量之前後改
- 渣除驗引而後刪
- 每階諸測皆通
- 總改已量且書
- 無行之退引入
- 入之制皆滿
陷
- 早優:無剖而優。先量,優熱徑
- 磨渣:費力改當刪之碼。先分後煉
- 破金:優而損至佳之碼。金只可增,不可減
- 無量之言:「似速」非點金。每改必量
- 優冷徑:費力於啟時一行之碼而瓶頸在請求環
參
— 全四階之化,於點金露碼需重構非只優athanor
— 針對之化於鉛元需範式之遷transmute
— 架構級之察補碼級點金review-software-architecture
— 資料管道之優類碼之優review-data-analysis