You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Replace the ask_operator rewrite with Guy's GaaS interview body, including AskUserQuestion. Keep slash /interview. Operator-ask mapping stays on native-integration.
Copy file name to clipboardExpand all lines: CHANGELOG.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,7 @@ parallel copies under `docs/` or `scripts/notes/`. At cut time: rename
19
19
20
20
### Changed
21
21
22
+
- Restore the interview skill body 1:1 with GaaS (AskUserQuestion). Operator-ask mapping stays on native-integration. Slash /interview remains.
22
23
- Restore the implement skill body 1:1 with GaaS (TaskCreate, @greybeard, Acknowledgment). Tool-name mapping stays on native-integration. Slash /implement remains.
23
24
- Restore the typescript skill body 1:1 with GaaS. bun:test vs tap mapping lives on native-integration. user-invocable: false stays so it remains use_skill-only.
24
25
- Restore the philosophy skill body 1:1 with GaaS (including the review acknowledgment). `user-invocable: false` stays so it remains use_skill-only.
description: Conduct an iterative multiple-choice interview using ask_operator. Returns the Q&A inline. Use as a utility when a caller needs structured user input on a topic.
4
+
description: Conduct an iterative multiple-choice interview using AskUserQuestion. Returns the Q&A inline. Use as a utility when a caller needs structured user input on a topic.
5
+
tools:
6
+
- AskUserQuestion
5
7
---
6
8
7
9
# Interview
8
10
9
-
Gather structured user input on a topic via multiple-choice `ask_operator` questions. Emit the Q&A inline; the caller decides what to do with it.
11
+
Use this skill to gather user input on a topic by asking multiple-choice questions in batches via `AskUserQuestion`. Return the questions and answers in the conversation. The caller decides what to do with them.
10
12
11
-
This is a utility, not a planner. It does not decide what to build, write any files, spawn agents, or invoke other skills.
13
+
This is a utility, not a planner. It does not decide what to build, write any files, or invoke other skills.
12
14
13
15
## Argument
14
16
@@ -17,50 +19,50 @@ This is a utility, not a planner. It does not decide what to build, write any fi
17
19
-**Topic** — what the interview is about
18
20
-**Context** (optional) — facts already known. Treat each as an answered dimension; do not re-ask things context settles.
19
21
20
-
If no topic is given, ask for one with `ask_operator`before proceeding.
22
+
If no topic is given, ask for one before proceeding.
21
23
22
24
## Process
23
25
24
26
### Identify dimensions to probe
25
27
26
-
Enumerate the open questions worth asking from the topic and context. Skip dimensions the context already settles. Add domain-specific ones where relevant. There is no fixed dimension list — the topic determines it.
28
+
Enumerate the open questions worth asking, drawn from the topic and context. Skip dimensions the context already settles. Add domain-specific ones where relevant. There is no fixed dimension list — the topic determines it.
27
29
28
30
Probe objective and priorities before details. They shape every later question, so anchoring them early prevents reshuffling halfway through.
29
31
30
-
### Ask with ask_operator
32
+
### Ask in batches
31
33
32
-
Each question is one `ask_operator` call: `question` (string) plus `options` (array of strings). Fire independent questions together as parallel tool calls in the same turn.
33
-
34
-
`ask_operator` is single-select per call. The operator can also type a custom answer. There is no multi-select flag — if a dimension genuinely permits several answers, encode the realistic combinations as options, or follow up once the first answer lands.
35
-
36
-
**No false caps.**`ask_operator` has no skill-invented ceiling on option count, parallel questions per round, or total rounds. Batch every independent dimension you can author now. Drop to one question only when the next question's text or options cannot be written without this answer. Stop when marginal value is low (see below) — never because a made-up quota was hit. If the caller passed an explicit cap, honour it.
34
+
Each round uses `AskUserQuestion`. Refer to the tool's own documentation for parameter limits and multi-select behavior.
37
35
38
36
**Quality bar for options:**
39
37
40
-
- Mutually exclusive **short labels** — not "yes / no / maybe"
38
+
- Mutually exclusive and concrete — not "yes / no / maybe"
41
39
- Each option a real, defensible choice — not a strawman
42
-
-Trade-offs, rationale, and context go in the **preceding transcript reply**, then `ask_operator`with a brief question and brief labels. Do not put essays in the option string — `options` are strings, not `{ label, description }` objects
40
+
-Descriptions surface trade-offs ("simpler but less flexible", "consistent with existing patterns")
43
41
- Ground options in the topic and context — do not invent generic options when concrete ones exist
44
-
-Combination options only when the dimension genuinely permits more than one answer
42
+
-Multi-select only when the dimension genuinely permits it
45
43
- If you have a recommendation, put it first and label it
46
44
47
-
Referencing a prior answer inside a later question's text is fine.
45
+
**Batching:**
46
+
47
+
- Default 2–4 questions per round, bundling dimensions that do not depend on each other
48
+
- Drop to 1 question only when the next question's text or options cannot be authored without this answer
49
+
- Referencing a prior answer inside a later question's text is fine
48
50
49
51
### Decide when to stop
50
52
51
53
Stop when:
52
54
53
55
- Every open dimension has been answered or marked out of scope
54
56
- Remaining unknowns are details the caller can reasonably decide
55
-
- The user has signalled fatigue (declines to choose, short non-substantive custom answers, asks to wrap up)
57
+
- The user has signalled fatigue (declines to choose, short non-substantive "Other" answers, asks to wrap up)
56
58
- The topic has shifted into territory outside this interview's scope
57
59
58
-
There is no fixed round cap. Stop when the marginal value of another round is low.
60
+
There is no fixed round cap. Stop when the marginal value of another round is low. If the caller passed an explicit cap, honour it.
59
61
60
62
### Handle trouble
61
63
62
64
-**Contradiction with a prior answer.** Ask one clarifying question that surfaces both choices directly. Record the resolution; do not silently overwrite.
63
-
-**Custom answer reveals a missing dimension.** Add it to the dimension list and continue.
65
+
-**"Other" reveals a missing dimension.** Add it to the dimension list and continue.
64
66
-**Topic shift.** If the user's answers reframe the topic itself, stop, emit what you have, and tell the caller the topic has changed.
65
67
-**No objective to anchor on.** If the user is fundamentally undecided about the topic's objective itself (not just details), stop without a findings list. Tell the caller what you learned, why you stopped, and what they should consider doing instead.
66
68
@@ -73,7 +75,7 @@ When the interview ends, emit the Q&A inline as a numbered list of question →
73
75
74
76
1. <question>: <answer>
75
77
2. <question>: <answer>
76
-
3. <question>: <answer (combination)> — <answer>
78
+
3. <question>: <answer (multi-select)> — <answer>
77
79
```
78
80
79
81
If the user declined some questions or punted a dimension, note it in the same list:
@@ -88,39 +90,28 @@ After emitting the findings, stop. Do not load other skills, invoke other agents
88
90
89
91
## Worked example
90
92
91
-
**Invocation:**`use_skill(name="interview")` with the topic in the conversation, or `/interview notification system; backend is Node/Postgres, internal users only, must integrate with existing auth`
93
+
**Invocation:**`skill(name="interview", arguments="notification system; backend is Node/Postgres, internal users only, must integrate with existing auth")`
92
94
93
-
**Round 1** (three parallel `ask_operator` calls — independent dimensions, so ask together). Trade-offs belong in the transcript before the calls, not in the labels — e.g. "critical vs activity vs re-engagement; never-miss vs real-time vs per-event opt-in; in-app vs email vs webhook."
95
+
**Round 1** (3 questions, bundled because none depends on the others):
94
96
95
97
```
96
-
ask_operator({
97
-
question: "What is the primary goal of the notification system?",
98
-
options: [
99
-
"Alert on critical events",
100
-
"Keep users informed of activity",
101
-
"Drive user re-engagement"
102
-
]
103
-
})
104
-
105
-
ask_operator({
106
-
question: "If you had to pick one, which matters most?",
107
-
options: [
108
-
"Reliability of delivery (recommended)",
109
-
"Latency",
110
-
"User control"
111
-
]
112
-
})
113
-
114
-
ask_operator({
115
-
question: "Which delivery channels do you want?",
116
-
options: [
117
-
"In-app",
118
-
"Email",
119
-
"In-app + Email",
120
-
"Webhook",
121
-
"All of the above"
122
-
]
123
-
})
98
+
AskUserQuestion([
99
+
{ header: "Goal", question: "What is the primary goal of the notification system?",
0 commit comments