Ask The Person

Skill id: ask-the-person

Generated from JSON Schema — do not edit by hand. Run bun run cat-harness-tools/scripts/gen-schema-docs.ts.

Input

One question for a person, complete enough to answer without opening anything. The same fields as DecisionRequestSchema in schemas/process/decision-request.ts, plus a letter per option so the chat text and the card use the same handles. Every field is required: a question with no comparison, no recommendation or no default does not validate.

FieldTypeRequiredDescription
decidesstringyesWhat is being decided, stated as what will DIFFER depending on the answer. Not the name of the decision. (minLength: 1)
contextstringyesWhy it is being asked now and what happens next: the PRs, beans and pages it touches, each named in words. Links are for more, never where terms are defined. (minLength: 1)
glossaryobjectyesEvery id, path and coined name used above, glossed. {} means nothing needs a gloss.
optionsarrayyes
recommendsstringyesThe letter of the recommended option; it is shown first and marked. (pattern: ^[A-D]$)
becausestringyesminLength: 1
ifSilentstringyesWhat will be done if no answer comes. Then it is done. (minLength: 1)
questionstringyesThe question itself, last. (minLength: 1)
othersPendingintegeryesHow many other decisions wait; given as a count, never as a list of option names. (min: 0)
reversiblebooleanyesfalse when acting on the answer cannot be undone. Then the default is never taken on silence: the step waits.

options[]

FieldTypeRequiredDescription
letterstringyesThe handle shown in BOTH the chat text and the card. (pattern: ^[A-D]$)
labelstringyesShort noun phrase the person taps. (minLength: 1)
doesstringyesminLength: 1
prostringyesminLength: 1
constringyesWhat it costs to do. (minLength: 1)
downstreamstringyesWhat it changes for everything else, afterwards. (minLength: 1)
reversibilitystringyesminLength: 1

Raw schema · ✎ Edit

Output

What the calling step gets back: proof the question went out twice, and the person’s answer or the default taken. A dismissed card is not an answer.

FieldTypeRequiredDescription
askedobjectyesWhere the two copies went. The chat copy is posted first.
outcome"answered" | "silent" | "dismissed"yesanswered: the person chose. silent: no answer came. dismissed: the card was closed without a choice; the question stays open in the chat.
chosenstring | nullyesThe letter chosen; null unless outcome is answered. (pattern: ^[A-D]$)
quotestring | nullyesThe person’s answer, verbatim, with who and when; null unless answered.
defaultTakenbooleanyestrue when the work went ahead on ifSilent. Never true for an irreversible step.
rulestringnoWhen the answer settles how a kind of thing is decided: the skill it was written into, in the same turn.
stagingLinksanynoWhen the question asks the person to look at changed pages: the staging preview, one deep link per changed page with the same page on main, shown in the chat copy. When there is no preview, say so in missing. Rule: cat-harness skills/authoring/content-lifecycle/feedback-deep-links.md.

asked

FieldTypeRequiredDescription
chatstringyesId or link of the chat message holding the full question. (minLength: 1)
cardstring | nullyesId of the card offered after it; null only when the host has no card tool, which the chat text then says.

Raw schema · ✎ Edit


folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev