Back to Skills

athanor

pjt222
Updated 6 days ago
24 views
17
2
17
View on GitHub
Designaidesign

About

The athanor skill is a four-stage alchemical process for systematically transforming tangled or legacy code into optimized, modern output. It decomposes, purifies, illuminates, and then synthesizes code, with checkpoints between stages. Use it when incremental refactoring has failed and a full-cycle transformation of a codebase or paradigm is needed.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/athanor

Copy and paste this command in Claude Code to install this skill

Documentation

煉爐

行碼或數之四階煉金轉化——nigredo(解)、albedo(淨)、citrinitas(明)、rubedo(合)——間置冥想與愈之察點。煉爐乃諸階保恆溫之爐也。

用時

  • 變遺碼為今之等乃用
  • 重構深纏模而漸修屢敗乃用
  • 轉碼庫於諸範間(程式至函式、巨石至模塊)乃用
  • 處原亂數為淨析數集乃用
  • 輕重構法已滯而需全環轉乃用

  • 必要:待變之材(檔徑、模名、或數源)
  • 必要:所求末態(目架構、範、或式)
  • 可選:已知約(須守 API、不可改庫模等)
  • 可選:前敗試與其滯之由

第一步:Nigredo — 解

破原材為構元。無神聖;一切錄。

  1. 全錄材:
    • 列每函、類、模、或數實
    • 映諸依(入、呼、數流)
    • 識隱耦(共全、隱態、副作)
  2. 露隱假:
    • 碼依何未書行?
    • 何錯條默吞?
    • 何序依存?
  3. 錄反式與技債:
    • 神物、環依、複貼重
    • 死路、不及枝、遺功
    • 硬值、魔數、嵌設
  4. Nigredo 錄:每元、依、假、反式之結構化錄

得: 材之全不退錄。錄當覺不適——若不然,解不徹。諸隱假今明。

敗則: 若材過大不可全錄,按模界解而各為獨煉爐行。若依過纏不可映,以 grep/Grep 追實呼位代文。

第二步:冥想 — 煅察點

meditate 以清 nigredo 所積之假。

  1. 置 nigredo 錄而清心境
  2. 錨於入所述之變目
  3. 察 nigredo 引之偏——解使某法似不可免乎?
  4. 標早解念為「旁」而返目

得: 清之無偏態備評材而不錨於當前之形。目覺新而非受現形所限。

敗則: 若 nigredo 發現屢引注(特惡反式、巧 hack 誘存),書而明置之。唯目清於當前形時進。

第三步:Albedo — 淨

別本於偶。去諸不事目形者。

  1. 自 nigredo 錄分每元:
    • :核業邏、不替算法、關數變
    • :框架皮、舊錯變通、兼容墊
    • :反式、安漏、死碼
  2. 取本元於孤:
    • 自框架皮取核邏
    • 別數變於 I/O
    • 自實取界
  3. 全除毒元——書除何與何以
  4. 偶元則定目形有等乎
  5. Albedo 取:淨本邏附清界

得: 一組純孤之函/模表原材之核值。每片可孤試。取顯小於原。

敗則: 若本偶過纏不可別,先立縫點(界)。若材抗淨,或需 dissolve-form 於煉爐續前。

第四步:愈 — 淨察

heal 察淨徹乎。

  1. 分 albedo 取:仍持毒殘乎?
  2. 察偏:淨偏於原變目乎?
  3. 察全:諸本元皆計乎、或早棄?
  4. 若需再衡:復誤分為偶之本元

得: 信 albedo 取全、淨、備明。無本邏失;無毒式留。

敗則: 若察顯要隙,返第三步附所識隙。勿於材不全時進 citrinitas。

第五步:Citrinitas — 明

見目形。映淨元於其佳構。

  1. 式識:識何設計式事淨元
    • 數流示管/濾、事件源、CQRS 乎?
    • 界示策、適、外觀乎?
    • 模構示六角、層、微核乎?
  2. 設目架構:
    • 映每本元於新位
    • 定組件間之界
    • 述新構中數流
  3. 識須新建者(原無等):
    • 統複邏之新抽象
    • 代隱耦之新界
    • 代默敗之新誤處
  4. Citrinitas 藍:自 albedo 取至目形之全映

得: 清詳之藍,每本元有家、每界有定。藍當覺不可免——予淨元則此構為自然合。

敗則: 若多有效架構競,對入之約評各。若無明勝者,擇最簡而書他為未來擇。

第六步:冥想 — 合前察點

meditate 備終合。

  1. 清 citrinitas 之析境
  2. 錨於 citrinitas 藍為合之導
  3. 察變之焦——何被急乎?
  4. 確備:藍清、材淨、約知

得: 所建之靜清。合階當為執,非設。

敗則: 若藍疑持,返第五步附具憂。精藍勝於疑而始合。

第七步:Rubedo — 合

組淨元於目形。賢者之石:行而優之碼。

  1. 循 citrinitas 藍建新構:
    • 建檔、模、界如所規
    • 遷每本元至新位
    • 實新抽象與界
  2. 連組:
    • 接數流如所設
    • 實新路誤傳
    • 設依注或模載
  3. 驗合:
    • 各組孤行乎?(單試)
    • 組正組乎?(整試)
    • 全系生同原之出乎?(回歸試)
  4. 除鷹架:
    • 除暫兼容墊
    • 除遷助
    • 清留於舊構之引
  5. Rubedo 出:已轉之碼,全行於新形

得: 行碼於原可量進:少行、清構、好試覆、少依。變已成,舊形可退。

敗則: 若合露藍隙,勿補——返第五步(citrinitas)改設。若組失,孤修之而後試整合。rubedo 不可生半變之嵌合。

  • Nigredo 錄全(諸元、依、假皆錄)
  • Nigredo/albedo 間冥想察點過(假清)
  • Albedo 取只含本元附清界
  • 愈察確淨全
  • Citrinitas 藍映每本元於目形
  • Citrinitas/rubedo 間冥想察點過(備合)
  • Rubedo 出過原行之回歸試
  • Rubedo 出可量進(繁度、耦、試覆)
  • 無毒元存於終出
  • 入之變約皆達

  • 跳 nigredo 之深:急解致合中隱耦露。盡投於錄
  • 存偶繁:戀巧變通或「行勿觸」之碼。非本則去
  • 跳冥想察點:一階之認知勢偏下一。頓為結構,非選
  • 無藍合:citrinitas 未盡前始碼生補丁,非轉化
  • 不全回歸試:rubedo 須重現原行。未試路默破
  • citrinitas 中範蔓:明階露原目外之進機。注而勿追——煉爐事所述之變,非臆想

  • transmute — 單函或小模之輕變
  • chrysopoeia — 值取與優(變基碼為金)
  • meditate — 階門察點之元認知清
  • heal — 淨驗之子系察
  • dissolve-form — 材過剛不可煉時先溶
  • adapt-architecture — 系級遷式之補法
  • review-software-architecture — 合後架構審

GitHub Repository

pjt222/agent-almanac
Path: i18n/wenyan/skills/athanor
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill

connect-mcp-server

Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill

web-cli-teleport

Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill