Agent tools
Questions to the user and the context of an agent. This group has 7 tools, 1 of them available only with spec-editor Pro.
| Tool | Edition | Summary |
|---|---|---|
answer_question |
Open core | Dismiss a question from questions.jsonl. |
ask_question |
Open core | List open questions for the user. |
compact_context |
Open core | Compact the agent context to free memory. |
get_question |
Open core | One question in full by id (text, answer, options, context), whatever its status. |
list_questions |
Open core | Show open agent questions from questions.jsonl. |
request_clarification |
Open core | Request clarification from a person. |
request_helper |
Pro | Request a helper agent for parallel work. |
answer_question
Dismiss a question from questions.jsonl. Sets the question status to answered.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
actor |
string | no | Who answers (recorded as human:<actor>) |
answer |
string | yes | Answer text |
project_path |
string | yes | Path to project root |
question_id |
string | yes | Question ID (e.g., Q-0001) |
ask_question
List open questions for the user. Use status=all to see all questions, or leave empty for open questions only.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
agent |
string | yes | Get answers from a specific agent (Agent 1 / Agent 2) |
options |
array of string | yes | Answer options for the user to choose from (required, non-empty) |
project_path |
string | yes | Path to project root |
question |
string | yes | Question text |
compact_context
Compact the agent context to free memory. Call when the context becomes overloaded.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reason |
string | no | Reason for compaction |
get_question
One question in full by id (text, answer, options, context), whatever its status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_path |
string | yes | Path to project root |
question_id |
string | yes | Question ID (e.g., Q-0001) |
list_questions
Show open agent questions from questions.jsonl. status=all — all questions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_path |
string | yes | Path to project root |
status |
string | no | open (pending answer) from all agents |
request_clarification
Request clarification from a person.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string | yes |
request_helper
Pro tool. Available with the spec-editor Pro plugin.
Request a helper agent for parallel work. role — role (modules/UI/scenarios/data/NFR), task — specific assignment.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
role |
string | yes | Helper role (modules, UI, scenarios, data, NFR) |
task |
string | yes | Specific task for the helper |