tlogben/baransu
バランス — deliberate before executing, verify after. Governance skills covering the full development lifecycle.
Ports or audits the Codex copy of a Claude Code skill, plugin or marketplace against both platforms' current official docs and the Codex source, reporting every gap with its source; edits only when asked. Trigger On '轉成 codex 版', '給 codex 用', '檢查 codex 版', 'port to codex'. Not for porting Codex to Claude.
Builds and sharpens a project's domain model while the user designs: challenges and settles terms in CONTEXT.md and records decisions as ADRs under docs/adr/. Trigger On '$baransu:domain-modeling', '詞彙表', '名詞定義', '統一用詞', '記一筆 ADR', 'glossary'. Not for choosing which way to build ($baransu:think).
Drafts the shape of a change before its code: writes how callers will use it, sketches types and signatures with bodies left unimplemented, has it drawn twice by designers who cannot see each other, keeps the shape the next contributor can extend, and leaves the sketch as the contract to build against; --deepen finds shapes worth redrawing in existing code. Trigger On '$baransu:draft', '畫骨架', '先打骨架', '先設計介面', '形狀怎麼切', '改善架構', 'sketch the shape', 'architect this'. Not for an undecided direction ($baransu:think) or reviewing finished work ($baransu:review).
Draws an idea, system, dataset or story as a self-contained piece: a static diagram, an interactive architecture map, a motion video, or an interactive animated figure. Trigger On '$baransu:draw', '畫一下', '圖解', '架構圖', '做成動畫', 'visualize'. Not For: restyling an app's UI or laying out a whole page ($baransu:ui).
Improves a SKILL.md round by round, keeping a change only when blind judges and a known-answer exam show it is strictly better at no added cost. Trigger On '$baransu:evolve', '優化 skill', '精簡 skill', 'skill 評分', 'improve skill quality'. Not for writing a new skill, or deciding whether one should exist ($baransu:think).
Audits a project's agent configuration and AI-coding maintainability — instruction drift, hooks, MCP, code-rot signals — and is the default for environment problems such as a missing CLI or 'command not found', and for a mistake the user keeps correcting. Trigger On '$baransu:health', '健康檢查', '檢查配置', 'hooks 沒生效', 'MCP 壞了', 'command not found', '又犯同樣的錯', '一直糾正', '讓它別再犯'. Not for reviewing one piece of work ($baransu:review).
Explains how a part of the codebase works, at the level a senior engineer needs to start working in it: runtime flow, key concepts, where things live, gotchas, and which layer owns what. Trigger On '$baransu:how', '這怎麼運作', '帶我看這塊', '這屬於哪一層', 'how does X work', 'walk me through'. Not for why it was built this way ($baransu:why), a current failure ($baransu:hunt), a paced lesson ($baransu:teach-me), or a picture ($baransu:draw).
Restates the last message in plain human language, with no jargon. Trigger On '$baransu:huh', '白話', '白話解釋', '講人話', '聽不懂'.
Tracks a bug from its symptom to the root cause before any fix — picks the observability tool, bisects, and confirms or discards each conjecture. Trigger On '$baransu:hunt', '排查', '查 bug', '為什麼失敗', '報錯', 'debug', 'not working'. Not for judging finished work ($baransu:review) or whether a fix is worth it ($baransu:think).
Use when a part of a system, a plan, or a document must not go wrong in any order or for any input and tests cannot reach the case — a race, a retry, a multi-step state, money, a permission, an irreversible effect, a schedule or plan that must be the best possible, a result needed under a time or memory limit, two documents that must agree, or code before and after a refactor that must behave the same. Trigger On '$baransu:hypothesis', '假說', '證明所有順序都不會壞', '最壞情況', '這個模組不能出錯', '文件有沒有矛盾', '是否滿足', '最佳化', '重構前後等價', 'model-check this'. Not for finding the cause of a failure ($baransu:hunt) or replaying on the real app ($baransu:prove-it).
Turns one or more sources into a structured learning note: a digest per source and an optional filled outline. Trigger On '$baransu:learn', '研究主題', '整理筆記', '學一下'. Not for saving a raw copy ($baransu:read --save).
Keeps a project's lint gate in .claude/lint/: copies baransu's preset into the project, adds, disables or changes the severity of a check, explains why a rule exists, and syncs the preset after an update; the baransu mod then runs each check at its timing — before, after or around an act, before a skill or the turn's end, and first thing when this skill is called — and shows the result in the chat. Trigger On '$baransu:lint', 'lint 規則', '加一條 lint', '初始化 lint', '這條規則為什麼', 'lint preset', '別再犯這個錯'. Not for diagnosing a failure ($baransu:hunt) or auditing agent config ($baransu:health).
Proves claims by running the real app the way its user does: that a reported problem really fails, and that work said to be done really works. Leaves a record of this version a review can read, and builds the project's run recipe on first use. Trigger On '$baransu:prove-it', '證明它', '跑跑看', '實際跑一次', '真的修好了嗎', 'prove it works'. Not for reading-only review ($baransu:review) or tracing a root cause ($baransu:hunt).
Reads a web page, file, or search result into the conversation as clean Markdown; keeps an offline copy under .claude/read/ only when asked to save or another skill will read it. Trigger On '$baransu:read', '抓網頁', '看一下這篇', '轉成 markdown', '存下來'. Not for digesting into notes ($baransu:learn).
Reviews a diff, PR, plan, artifact, or quoted claim against what the user asked for, by reading only: finds every place that no longer holds with the change and reports each with two citations and a verdict. Trigger On 「看一下」「幫我看」「check 一下」「review 一下」「是不是做過頭了」, "take a look at X". Not for a reported error ($baransu:hunt) or the project's agent config ($baransu:health).
Restates in its own words what it thinks the user's goals are and what problem they are trying to solve, so the user can confirm it understood. Trigger On '$baransu:sayagain', '你知道我想幹嘛嗎', '確認一下你懂我', '重述我的目標'.
Wraps up a session: archives baransu working directories, commits under the repo's own identity and message style, pushes, merges one-way into named targets ($baransu:ship uat main), and removes the worktree. Trigger On '$baransu:ship', '收工', '上傳收尾', '結束這輪'.
Shows the current topic as the smallest visual that makes its point: pseudocode, a call tree, a file tree, a diff, a Mermaid diagram, or one focused HTML page. Trigger On '$baransu:show-me', '畫給我看', '用圖說', '給我看差異', 'show me'. Not for teaching a whole subject ($baransu:teach-me) or a finished standalone figure or video ($baransu:draw).
Teaches a body of work until the person actually understands it — code, a change, a subsystem, or a $baransu:learn note — drawing on $baransu:how and $baransu:why or the note, one plain step at a time, in conversation. Trigger On '$baransu:teach-me', '教我', '讓我真的懂', '解釋給我聽', 'teach me', 'help me understand'. Not for restating your last message ($baransu:huh) or writing a study note ($baransu:learn).
Deliberates before building: aligns on what the user actually wants, takes a stance with its bets named, and leaves a plan under .claude/think/ — never code. Use when an idea, feature, refactor or direction is undecided, or a decision needs testing. Trigger On '$baransu:think', '想一下', '怎麼設計', '值不值得', '有沒有更好的做法', 'grill me'. Not for debugging an error ($baransu:hunt).
Designs or restyles the web UI in the user's repo with deliberate palette, type, layout and motion, writing the UI files directly; can learn a style from a reference site or image, and builds explanatory pages that embed $baransu:draw figures. Trigger On '$baransu:ui', '美化', '調 UI', '看起來太 AI', '照這個網站的風格', 'make it look designed'. Not For: a single diagram, video or interactive figure ($baransu:draw).
Catches the user up on what changed in this conversation since their last message, in plain words and small visuals, then lists every call waiting on them with enough to decide it from the reply alone. Trigger On '$baransu:what-now', '現在呢', '我回來了', '進度到哪', '剛剛發生什麼', 'catch me up'. Not for restating the last message ($baransu:huh) or the user's goal ($baransu:sayagain).
Explains why code or a design decision has its current shape, from repo history, agent plans and transcripts, and connected docs; each claim cited and tiered, gaps named. Trigger On '$baransu:why', '為什麼這樣寫', '當初為什麼', '這段的由來', 'design rationale'. Not for a current failure ($baransu:hunt), how it runs ($baransu:how), or whether to change it ($baransu:think).
Refines text, writes a piece from a prompt, or proofreads a document into an error-report page, in Chinese or English. Trigger On '$baransu:write', '潤稿', '寫一篇', '改寫這段', '校對', 'proofread'. Not for digesting sources into notes ($baransu:learn).