shift-dev
Build, test and debug Shift itself — the Guile module layout, the compiled-vs-source trap, running one suite instead of all of them, and where a new module has to be registered. Use when editing anything under src/live-agent, extensions/shift, or agent/.
- License 许可
- MIT
- 所属仓库
- thrashr888/shift
- 最近更新
- 2026-09-25
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- shift-dev
- description
- Build, test and debug Shift itself — the Guile module layout, the compiled-vs-source trap, running one suite instead of all of them, and where a new module has to be registered. Use when editing anything under src/live-agent, extensions/shift, or agent/.
03 SKILL.md 正文
Working on Shift
Layout
| Path | What it is |
|---|---|
src/live-agent/*.scm |
the permanent runtime: authority, transport, tools, session |
extensions/shift/*.scm |
trusted built-ins reached through builtin-ref, including tracing and the provider adapters |
agent/default.scm |
the live image. User-owned data, not runtime code: bindings here are what live_eval rewrites at runtime |
test/*.scm |
SRFI-64 suites |
test/*.py |
integration tests that drive bin/shift-agent against a fake provider |
Build before you test
make build
bin/shift-agent and the tests load compiled modules from build/ and fall
back to source when a .go is stale. The fallback is silent, so an edit you
forgot to compile does not fail — it just tests the old module in some paths
and the new one in others. Run make build after editing any .scm under
src/ or extensions/. make -n build lists what is stale without compiling,
and the DEV pane shows the same thing.
Tests
make test # every Guile suite plus every Python test; ~3 minutes
make check # the same target
make test runs longer than a default command timeout, so give it room or run
it in the background rather than assuming it hung.
One suite at a time:
guile -L src -L extensions -C build test/run.scm test/receipt.scm
This asks for approval every time and is meant to. test/run.scm loads
whatever path follows it, so allowlisting any prefix that reaches it would let
a file be written and then executed without approval — the shell boundary this
project keeps closed. make build, make test, make check and make -n are
allowlisted instead.
Registering a new module or suite
- A new
src/live-agent/NAME.scmis compiled automatically: the Makefile globsCORE_SOURCES. - A new
test/NAME.scmis not run automatically. AddNAMEto the suite list in the Makefile'stest:target or the suite never runs, and a greenmake testwill mean nothing about it. - A new
test/NAME.pylikewise needs its ownpython3 test/NAME.pyline.
Two traps worth knowing
SRFI-64 tests after test-end are silently skipped. Appending a case below
(test-end "name") leaves it unexecuted while the suite still reports success,
with the pass count unchanged. If a case you just added does not appear in the
output, check that it sits above test-end.
Tool schemas are charged on every request. Several integration tests pin a
tight context-limit, so lengthening a tool description in
src/live-agent/tools.scm can push an unrelated turn over its budget and fail
it with "Context still exceeds the budget". Put instructions the model needs
only after calling a tool in that tool's output rather than its description.
Debugging a session
traces.jsonl in the session folder holds every span. In a session, the
traces tool searches it and fetches a span by span_id; outside one,
python3 scripts/evals.py session NAME gives a per-turn review with rounds,
failures, waits and judge disagreements.
04 同仓库更多 Skills
tauri-browser
暂无简介
ripwire
Answer "who calls this", "is it safe to change", "which tests cover it" and "where do I start in this repo" from a call graph instead of grepping and reading files. Use before editing a symbol, when a test fails with a trace, and when landing in an unfamiliar codebase; not for Scheme, which it cannot parse.
onepassword
Work with the user's 1Password through the op CLI for non-secret operations (which vaults and items exist, whether a session is signed in) and know how Shift gets secrets from it. Use when a server or command needs a credential, or the user asks about their vaults.
kanban
Keep and change this project's board — read the columns, move a card, add or retire one. Use when asked what is in progress, what to pick up next, or to move a card between columns.
cortex
暂无简介
cider
Read and act on macOS Apple apps (Calendar, Reminders, Contacts, Notes, Mail, Music, Safari, Home and 30 more) with the cider CLI, which prints JSON. Use when the user asks about their calendar, reminders, contacts, notes, mail or Mac state, or wants one of those changed.