emacs-tashaki
The wearable omni for Emacs work in the C4 tree — put it on for a stretch of Emacs-side building and it dispatches to the right sub-discipline, carrying the house conventions so you don't re-derive them. Use whenever work touches the C4 Emacs prong: c4-diagram.el / c4-model.el / c4-surface.el, the tabulated-list property panel, the SVG render, the console/-nw twin, ERT + emacs/run-tests.sh, byte-compile warnings, he2ma (sandbox Emacs, --gui image build), the card-games community header idiom, or the canonical diagram doc + the plist↔JSON bridge. Triggers on "work the Emacs side", "the Emacs prong", "c4-diagram.el", "run the Emacs tests", "he2ma", "wear emacs-tashaki", "Emacs parity", or any C4 elisp being authored/tested/rendered. NOT general Emacs config (that's the user's dotfiles), NOT the web worksurface.
- License 许可
- GPL-3.0
- 所属仓库
- inputloop/garden
- 最近更新
- 2026-10-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- emacs-tashaki
- description
- The wearable omni for Emacs work in the C4 tree — put it on for a stretch of Emacs-side building and it dispatches to the right sub-discipline, carrying the house conventions so you don't re-derive them. Use whenever work touches the C4 Emacs prong: c4-diagram.el / c4-model.el / c4-surface.el, the tabulated-list property panel, the SVG render, the console/-nw twin, ERT + emacs/run-tests.sh, byte-compile warnings, he2ma (sandbox Emacs, --gui image build), the card-games community header idiom, or the canonical diagram doc + the plist↔JSON bridge. Triggers on "work the Emacs side", "the Emacs prong", "c4-diagram.el", "run the Emacs tests", "he2ma", "wear emacs-tashaki", "Emacs parity", or any C4 elisp being authored/tested/rendered. NOT general Emacs config (that's the user's dotfiles), NOT the web worksurface.
02 资源文件 14
- 其他.arc/2026-09/signature-2026-09-23_pre-header-pass.asc659 B
- 其他.arc/2026-09/signature-2026-09-24_162126Z_pre-manifest.asc659 B
- 其他.arc/2026-09/signature-2026-09-27_203833Z_pre-manifest.asc659 B
- 参考文档.arc/2026-09/SKILL-2026-09-11_Archived-by-rcw-01dwoah4hj9uxpj4dacwrb2p.md5.4 KB
- 参考文档.arc/2026-09/SKILL-2026-09-27_pre-hardening.md5.9 KB
- 其他.arc/2026-09/skill-manifest-2026-09-23_pre-header-pass319 B
- 其他.arc/2026-09/skill-manifest-2026-09-24_162126Z_pre-manifest564 B
- 其他.arc/2026-09/skill-manifest-2026-09-27_203833Z_pre-manifest77 B
- 其他.arc/2026-10/signature-2026-10-10_104825Z_pre-manifest.asc659 B
- 参考文档.arc/2026-10/SKILL-2026-10-04_pre-c4-optional.md6.8 KB
- 其他.arc/2026-10/skill-manifest-2026-10-10_104825Z_pre-manifest77 B
- 其他.arc/receipts/aw2ri-2026-09.log210 B
- 其他.signature.asc659 B
- 其他.skill-manifest77 B
03 SKILL.md 正文
emacs-tashaki — the wearable omni for C4's Emacs prong
Put this on for a stretch of Emacs-side building in the C4 tree. Like a courier (takushi), its job is to route an Emacs task to the right sub-discipline and carry the house conventions with you, so you don't re-derive them each time. It does not replace the specialist skills it names — it dispatches to them.
The authoritative details live in the C4 tree; this omni is the map, not a copy. Read the named files when a lane is active.
Without a C4 tree
This skill is a map of one tree. With no C4 checkout in reach ($C4_ROOT, else /f/claude/c4, else
~/mnt/c4), say so in one line and stop routing: none of its lanes exist, and nothing here should
be read as a reason to install C4. General Emacs help is the ordinary help, without this omni.
The map — which lane, and where its truth lives
- The model (one model, several homes).
emacs/c4-model.el(fragments, interlink MOVE, patch-intent, strings-compose, org↔md round-trip) andemacs/c4-diagram.el(shapes/edges, control points, facing-pair connect, treatment palette, SVG render). The canonical document + the cross-fabric contract:h/MODEL-diagram.md. The plist ↔ JSON bridge (c4-diagram-doc->json/json->doc) reconciles symbolkind/nib↔ string and:from-cp↔fromCP; it round-trips to identity and node reads its output — the four fabrics share one wire form. (HTML superset fields — face/group/_expr, paradigm/ anchor/systems — extend per field as the Emacs model grows them.) - The property panel (the accessible face).
c4-diagram-props-of(a typed schema per object: text/enum/num/color/bool/ro),c4-diagram-set(write-back),c4-diagram-props-mode(atabulated-listwith RET-to-edit) — the list-twin /customizeface of every capability. Adding a feature = add a row toprops-of; it renders and ports for free. - The surfaces. GUI SVG image when
(display-graphic-p)+ svg; atabulated-listtwin under-nw(the a11y ramp). The test matrix names all three: console(-nw) / simple-SVG(file) / fullboth(GUI). The GUI pixels can't be batch-rendered — SIGN them (human-verified at a real Emacs), never claim tested. - Sandbox Emacs.
bin/he2ma— download-and-extract (never install; no root). Default fetchesemacs-nox27.1;he2ma --guifetches the image-capableemacs-gtk(svg/png link). The three env vars are the whole trick:LD_LIBRARY_PATH(extracted libgccjit),EMACSLOADPATH(…/lisp),EMACSDATA/DOC(…/etc). 27.1 lies on newer org — the version prints on every run.he2mais signed (Corwin's pen); changing it is a STOP-AND-TALK, archive the prior.ascfirst. - Running the tests.
sh emacs/run-tests.sh— host-first (prefersemacson PATH with no sandbox env; he2ma only as a Linux-sandbox fallback), covers both prongs, byte-compile + selftests + ERT. - The house header (community standards). The card-games idiom:
;; Copyright (C) YEAR Corwin Brust, then Author / Maintainer / Version / Package-Requires / Keywords / URL, full GPL boilerplate,-pkg.el,;;; name.el ends here. Static model atemacs/COMMUNITY-STANDARDS.md. Apply to every new.el.
Standing cautions (the things that bite, learned the hard way)
- Corwin's
nodeis NOT on PATH (on the author's machine:/c/Program Files/nodejs/node; check yours withcommand -v node). An alias must escape the space inside its value, because bash re-tokenizes an alias on use — a quoted value (alias N="…") FAILS (bash: /c/Program: No such file or directory). His working form:alias N=/c/Program\\\ Files/nodejs/node. And a relativerequirefails from the wrong dir —cdto the C4 root first (/f/claude/c4on the author's machine). - His host Emacs is 31.0.90 and is the strict reader: it flags docstrings whose TEXT (inside the
quotes) exceeds 80 columns; the sandbox 27.1 does not. Wrap docstrings ≤80 before you hand anything back.
A deep-nested
append/listis where a paren-imbalance hides —check-parenscatches it early; preferpush/nreverseover deep nesting. - Verifying is reading: a tree edited from the sandbox can't be verified there — say "I can't see this," never "BAD" (sandboxer / verify-say).
- The eyeball renderer is librsvg (
rsvg-convert), never ImageMagick — ImageMagick ignoresfill-opacityand SVG markers and will lie to you. Resolve CSS vars to literals first.
How to hand a result back
One hand-test per completed unit (chat-native, DO/- [ ]SEE steps, every command proven in-sandbox
first). Deliver it in the chat, not a file — see how Corwin reads.
Interlocks (dispatch targets, not re-implementations)
he2ma deck (decks/emacs-in-sandbox.deck.md) · hand-test (result delivery) · mentat-skill (notes) ·
skilltank/skill-creator (grow the kit) · prove-a-promise (the JSON bridge) · sandboxer +
verify-say (reading/mount honesty) · signing-model/shelf-check (he2ma's signature).
How this skill can fail (falsifiers)
- The map went stale. fails if a file this map names is gone from the C4 tree; check:
cd "$C4_ROOT" && ls emacs/c4-model.el emacs/c4-diagram.el h/MODEL-diagram.md emacs/run-tests.sh emacs/COMMUNITY-STANDARDS.md bin/he2ma. - Green on the lenient reader. fails if "tests pass" came from sandbox 27.1 alone; check: quote the Emacs version
emacs/run-tests.shprinted, and want the host's. - GUI claimed tested. fails if a hand-back calls the GUI SVG render tested rather than signed by a human at a real Emacs; check: read the hand-back's GUI line.
- A docstring over 80. fails if a handed-back
.elhas a docstring line wider than 80 columns; check:awk 'length > 80' FILE.el, then a host byte-compile with no warnings.
<!-- footer: minted by bin/ft1mt from conventions/house.env and conventions/FOOTERS.org; edit those, not this --> Version 1.1.0: edition revised from 1.0.1 on 2026-10-10; spine: 2026-09-11.
Copyright 2026 Corwin Brust corwin@bru.st and Contributors; CC-BY-SA4: https://creativecommons.org/licenses/by-sa/4.0/ (scripts GPL-3.0-or-later); Mentat (for Corwin; claude-opus-5-5) <!-- /footer -->
04 同仓库更多 Skills
alpha
暂无简介
gamma
暂无简介
quiet
A fixture skill that declares no preferences, so skill.quiet.* has no reader.
demo
A fixture skill for tests/prefs-declared-spec.rb; it declares two preferences inline.
concise
Synthesized by polygram from memory tag 'concise'. explicitly flagged. Review and tighten this description before relying on it for triggering.
writing-forms
Which writing form a dated deliverable takes in the shop, and the five techniques every form shares. Use whenever someone is about to write a dated deliverable — "which form is this?", "write it up", "land a note / card / model / lens", "what shape does a … take", "is there a form for this", or when a new PREFIX-date-slug filename is about to be minted. Carries the rule that a deliverable picks ONE form and says so in its filename, points at the register c/wf (columns d/c/wf) as the source of truth, names the most-used forms, the five cross-cutting techniques (two piles · cite at the act · a falsifier on every concern · the pair rule · his words), how a new form is born, and the fence on notes other sessions wrote. Not rolls (report kinds and their guards), not reformat-prompt (the REFORMAT pair), not run-card (the RUNCARD), not skill-creator (skills). Owns the FORM, not the content.