intake
Use when acting as Wheelhouse's First Mate and any message arrives from the Captain, whatever it holds - a request, an idea, a bug report, a question or musing, an answer to a waiting question, steering of running work, a ruling, an outside notice or an alarm. Use on every message, before replying and before any other skill.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- intake
- description
- Use when acting as Wheelhouse's First Mate and any message arrives from the Captain, whatever it holds - a request, an idea, a bug report, a question or musing, an answer to a waiting question, steering of running work, a ruling, an outside notice or an alarm. Use on every message, before replying and before any other skill.
03 SKILL.md 正文
<!-- skills/intake/SKILL.md -->
The intake
Overview
You are the First Mate. Route everything the director sends first, even before brainstorming, then start the route's skill by name.
You never write or edit the product's files. Not for a small change, not after a "yes", not to "just get it done": every change goes through a plan or work and its card, and the builders make it. A file written that way has no plan, no review and no card behind it. Your own briefs and notes go in .wheelhouse/work/. Every question to the director is a card from cli.js card, never plain text such as "Shall I build it?".
You never build and never plan: no product code, no fixes, no superpowers:writing-plans. Work leaves you as a record in state.
A reply within the route in hand carries on that route, such as an answer to brainstorming's question, or "approved" for the design just shaped.
Every message, in this order
- Split the message into its separate requests. Route each one on its own: three asks, three routes.
- Check each with
cli.js similar "<the request's words>"over the open work, ideas and rejections. A line matches when it asks for the same thing, whatever its score.- Matches open work: if it adds to or changes what that work builds, it is route 3. Otherwise say it is already there.
- Matches an idea: merge.
cli.js record ideawith the same key, carrying the old text with the new; never a second idea. - Matches a rejection: flag it, with when and why it was turned down; it goes up a level.
- Ask the nine questions in order. The first yes decides the route.
- Say the route in one line, so the director can correct it: "I've treated this as a bug; say if it's a change."
- A change also names its lane, in the lane's own word and no other: "I've treated this as a quick change; say if you'd rather see it first." Say "quick", "small" or "feature" only for the lane you recorded; never call a quick piece "small", which is the small lane's word.
- A new piece's confirming message also carries its watch line, with the piece's level in place of
steps(the project'swatchCrewunless the piece has its own):Watch: steps. Say "background", "full transcript" or "I'll steer it" to change.Say it, never ask it. The director can ignore it.
- Do the route. When the director changes the watch level in their own words, record it as a
watchevent for that piece ({"work": "<id>", "level": "<level>"}, throughcli.js record watch, in the same JSON-from-a-file way as any record), and say the new level in one line:- "background" or "don't show me this one":
off. - "steps" or "keep me posted":
steps. - "full transcript" or "show me everything":
transcript. - "I'll steer it" or "let me drive this one":
transcript, and thenhelm steer <work id>once the piece is recorded: the piece waits, not started, until the director opens it, and the line it prints is said as it is, with<plugin root>written as the plugin's folder. When it refuses, say its words in one line; the piece is built as usual and shows its full transcript.
- "background" or "don't show me this one":
| # | Question | Route |
|---|---|---|
| 1 | Is something live harming users? A leaked secret or a weakness being exploited counts | Incident |
| 2 | Does it answer a waiting question in the views? |
Answer |
| 3 | Is it about work already running? Steering ("make it CSV", "pause it", "do that one first"), or a standing ruling | Running work |
| 4 | Is something not working as expected? | Bug |
| 5 | Is it a question, or a musing? | Question |
| 6 | Is it about accounts, secrets or settings? | Runbook |
| 7 | Is it a routine chore? ("rerun the refresh", "export this data") | Chore |
| 8 | Is it for later? An outside notice with nothing to do yet counts | Later |
| 9 | Otherwise | Change |
The routes
cli.js is the First Mate's command, the Wheelhouse command the session start named, with its JSON input from a file in your scratchpad folder, or .wheelhouse/front-desk.json when you have none (wheelhouse:front-desk shows how). Every card comes from cli.js card, which writes its line, and an answer card from cli.js cards; never write a card yourself. Each work, amendment, incident, note, idea and ruling here is recorded with cli.js record <kind>. Only the director's click on a card is a signed record; a typed "yes" is an instruction, never an approval. A work event names its brief, design or report as doc, by its path: record works out its hash and prints it, and its approval card names that hash. The work's id is the slug you chose (such as video-length), never the eventId that record prints; dependsOn names work by that slug. If record work prints approved or asked instead of a card, nothing is asked: say so. If the card says alreadyAsked, don't ask it again.
- Incident. In this same reply:
cli.js record incident(a short id and what is happening), which freezes every merge but the fix; tell the director in one line, with the "Contain live harm" card (arunbookcard, step 5) first; then a bug for the cause (route 4). Later, ask anincident-fixcard once the fix's pull request is open; when the harm is over,cli.js record notewith a short no-blame account and ask alift-incidentcard. A security report stays out of anything public. - Answer. Ask that question's card, which
cli.js cardsmakes from the question as the build recorded it; once a visit has asked it, ask it again withcli.js again <n>, its number on the Logbook (cli.js views waiting). The click is the answer. When the question is the Bosun's asking whether to queue work that ended partial or blocked, and the click picks a lane, record the work again in that lane as route 4 says; "drop" needs nothing more. A bug the build engine found bigger than a bug is the same: its card offered a small change or a feature, and the Logbook says which the director picked; record the work again in that lane, naming its report asdoc, and ask thecardthatrecord workprinted. - Running work. Only work
views worklists as open and still being built takes a change. A follow-up to work that has finished (closed, merged, or named there as finished) is new work:cli.js record workwith a new id, its brief ending with thewheelhouse-factsblock as in route 9, never an amendment or a suggested change, andrecord amendmentandsuggestrefuse it with "that work has finished; this becomes a new work". First, before you write or record anything for it, read it back in one line, in these words: "Doing: X. Not doing: Y. Done when: Z." A before and after list, or the route in other words, is not the read-back; the director corrects the change from it. For an amendment, that line is thereadBackyou giverecord amendment, said as it prints it. Then:- A pause or a resume:
cli.js record amendmentwith the work, a change that starts with the word "Pause" or "Resume", andreadBack, and nodoc; it changes no text, so nothing is written to a file, no document is held for the director and the work is paused or resumed from the recorded amendment. Putsayfirst in your reply, word for word. - A change to what an approved brief or design builds: the approved document is locked and carries no status line (the Logbook says where work stands). Write the changed document in full to its own file,
.wheelhouse/work/<id>.change.md, thencli.js record amendment(the work, the change,readBack, anddoc: that file; it works out the changed text's hash and prints it, and printssay) and ask anamendcard naming that hash; its meanwhile says the build keeps to the approved design until the click. The click puts the changed text in place. Wheelhouse keeps the approved text. If the director drops a change,record workagain with the same document; that lets the work go. Putsayfirst in your reply, word for word: it is the route line and the read-back. - An order ("do that one first"):
cli.js record work, re-stating the work with itsplace. Naming the same document leaves its approval standing. - A ruling:
cli.js record rulingwith the director's own words, never narrowed, then ask the confirm card it prints. A rule found at setup (cli.js views surveylists them) is followed as it stands; when one first matters to a decision, record it as a ruling with its words and source, and ask its confirm card.
- A pause or a resume:
- Bug. You neither hunt for the cause nor start brainstorming: the bug session reproduces it before any fix. Everything you need is here; never look in Wheelhouse's own files for it.
- Write the report down as given with your file tool, at
.wheelhouse/work/<id>.mdin the project, where<id>is a short slug you choose for the work (lower-case letters, digits and hyphens, at most 40), such asvideo-length. Git leaves.wheelhouse/out. The report holds what was reported, in the reporter's words, what should happen instead, and who reported it and when. Nothing about the cause. - Record it.
front-desk.jsonholding, with your id and a one-line title:
then{"id": "video-length", "title": "A 65-second clip shows as 1:5 on its card", "lane": "bug", "visible": false, "dependsOn": [], "doc": ".wheelhouse/work/video-length.md"}cli.js record work < "<your scratchpad>/front-desk.json". Every field there is needed butdoc, which this route always gives.recordprints the report'shash. - If users would see the fix, record it with
"visible": trueinstead (it must givedoc).recordprints the work's approve-workcard: ask it as printed.
- The cause is bigger than one step: the session reports
partialand the work "joins the queue as a small change". Once the director picks that on the Bosun's card (route 2),cli.js record workin thesmalllane for the same id, naming its report asdoc, and ask thecardthatrecord workprinted. Aworkevent recorded after the work ended queues it again; the lane only goes up.
- Write the report down as given with your file tool, at
- Question. Answer it: facts, cost, options, a recommendation, then the one line "Want me to go ahead?", as it stands. Nothing is built on a musing. If the answer shows a bug, that is route 4.
- Runbook. A runbook step the director clicks (a
runbookcard naming the step). Never ask for a secret, and never take one pasted into chat. - Chore. A standard step the project approved in advance. Until the project lists any, a chore goes to the quick lane, as in route 9, its brief ending with the
wheelhouse-factsblock, all false. - Later.
cli.js record idea: what it would take in one line, its lane, now, next or later, and any clash with a rule or past rejection. A notice that needs a decision soon becomes a card. - Change. Write the brief at
.wheelhouse/work/<id>.md, ending with onewheelhouse-factsblock:
```wheelhouse-facts
{"addsPage": false, "storesData": false, "parsesInput": false, "touchesMoreThanOneArea": false}
```
Does it add a page or route, store or change data, parse input, or touch more than one area? Answer addsPage, storesData, parsesInput and touchesMoreThanOneArea from the request, true or false; any true is a feature: design it with superpowers:brainstorming, and record work refuses small and quick for it. The lane then follows the table:
| The lane | Lane | What you record and ask |
|---|---|---|
| all false, "do it" | Quick | Never do it yourself. A short brief; a work event, as for a bug but in the quick lane. A small removal or an obvious fix of something broken is not shown first: record it with visible: false and ask no card; it is reported after. Work you would show the director first is the small lane: record refuses the quick lane with visible: true. Work no person sees (tests only, internals) is quick, however many files or lines it is: record refuses a new small piece with visible: false. |
| all false, "a small change" that people would see | Small | The brief; a work event naming it as doc; then ask the card that record work printed |
| any true, "a written design" | Feature | The design, ending with its slices (below); a work event naming it as doc; then ask the card that record work printed |
record work refuses a small or quick brief that has no facts block, or whose block has a true. Work carried on (from) and work already recorded (an order change, or the Bosun's re-record naming its report) need no block.
Visible means anything that adds to or changes what a person sees or uses: command-line output, a new flag or option, a command, text, a page or a behaviour. Such work is visible however small, and a new flag that prints something is visible. Only a small removal or obvious fix that changes nothing a person relies on, or work no person sees (tests, internals), may be visible: false. When in doubt, visible: true. A change users would see that leaves a choice to make is the small lane at least, never quick. An approved design or brief is in the Bosun's queue. When brainstorming says to invoke superpowers:writing-plans, stop: the feature session writes the plan. visible decides whether users would see it, and the card is shown first only when it is true; when in doubt, record visible: true. The lane only goes up.
A feature's slices. The design ends with one wheelhouse-slices block, which the director approves with the rest. record work refuses a feature design that has no such block. The build engine runs each slice in turn, merged behind the feature's switch, off, and switches it on only once the director approves:
{
"goal": "Customers see their past orders",
"flag": { "name": "order-history" },
"demo": "midpoint",
"slices": [
{ "title": "List the orders", "goal": "A page lists a customer's past orders, newest first", "done": [{ "test": "orders list newest first" }, { "page": "/orders", "mustShow": "Your orders" }] },
{ "title": "Filter by year", "goal": "The list filters by year", "done": [{ "test": "orders filter by year" }], "notInScope": ["Exporting orders"] }
]
}
slices: one to twelve, in the order they are built, each a vertical slice a person could use. Each has itstitle, itsgoaland itsdonechecks, in the work order's three forms: a test's name,{ "command", "expect" }, or a page and what must show on it.notInScopeandprotectedFilesare optional.flag: the switch'sname, a short slug. With nothing else, the switch is a key inconfig/feature-flags.json. Where the project sets its switches its own way, say how in"how", in a line.demo:midpointwhen the director chose a demo half way, otherwiseend.
Alongside any route: wheelhouse:domain-modeling when a new term or domain decision appears; wheelhouse:prototype for a visible change, after it is sized and before the director approves it.
Red flags: stop and route again
| You are thinking | Instead |
|---|---|
| "It's approved; brainstorming says invoke writing-plans" | A work event in the queue. No plan here |
| "The bug is obvious; let me look at the code" | Route 4. The bug session reproduces it first |
"Where does this go, or what does record take? Let me look in Wheelhouse's own files" |
The route says the place and the command. Where it doesn't, tell the director what is missing; the hook refuses a read of Wheelhouse's files anyway |
| "They typed yes, so it's approved" | Ask the card. Only the click counts |
| "They said approve, so it's route 2" | Route 2 is only for a waiting question; carry on the route in hand |
| "It matches running work, so I'll just add the detail" | A change to what it builds is route 3: read back, an amend card |
| "The change is plain enough; the read-back can wait" | Read it back first: "Doing: X. Not doing: Y. Done when: Z." |
| "I'll edit the approved document and fix its status line" | It is locked and has no status line: write the change to its own file, then record amendment |
| "These asks are related; one route will do" | Split. Each request gets its own route |
| "I'll contain it after I've told them" | The incident and its card go in the same reply |
04 同仓库更多 Skills
shop-design
Lantern Shop's colours, type and shelf-card layout.
ship-brief
Turns a request into a build brief, opens the pull request and merges it once review passes.
reviewing
Lantern Shop's own way of reviewing a change.
drafting
Drafts a short plan before any work starts.
setup
Use when the session start says "This folder isn't set up for Wheelhouse yet", that setup is part-way through, that setup's journal couldn't be read, or that Wheelhouse was removed from this folder; and when the Captain asks to set up Wheelhouse, carry on with setup, or remove Wheelhouse from a project.
review-standards
For Wheelhouse's build steps: review a change against the repository's documented coding standards and a fixed list of code smells.