AGENT SKILL

report

The report that every sage agent ends with: STATUS, RESULT, EVIDENCE, FINDINGS, QUESTIONS, NOT VERIFIED, BRANCH. Use at the end of any task that the sage chief of staff gave you. Claude Code only.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 2
Forks
0

01 前言 Front Matter

name
report
license
MIT
description
The report that every sage agent ends with: STATUS, RESULT, EVIDENCE, FINDINGS, QUESTIONS, NOT VERIFIED, BRANCH. Use at the end of any task that the sage chief of staff gave you. Claude Code only.

03 SKILL.md 正文

The sage report

End your work with this report, and nothing after it. The chief of staff reads many reports, so keep it short: about 2,000 tokens or fewer, with long material in files that you name. The sage hook does not let you finish until each field starts a line. Write "none" in a field that has nothing.

STATUS        done, blocked or question
RESULT        the outcome, in the words your brief asks for (for example PASS or FAIL, CLEAN or FINDINGS)
EVIDENCE      each command you ran and its result; the paths of screenshots or output files
FINDINGS      none, or one line for each problem: - <key> <severity> <summary>, where the severity is high, medium or low and the summary gives the location and the steps that show it
QUESTIONS     each product question, its options and your recommendation
NOT VERIFIED  what you did not check, and why
BRANCH        the branch, its full 40-character head SHA (the commit you checked, after the word head) and the pull request link

Give each field once, at the start of a line that is not in a list or a code block. Under FINDINGS, write none alone, or one line for each finding in that form: a dash, the key, the severity, then the summary, for example - F1 medium src/app.js:12 an empty name saves a blank row. The key has a digit (F1, K2). Put any detail of a finding, such as the attack or the steps, on indented lines under its line. If a line names a severity above the finding's, write that problem as its own finding line. A role that finds no problems, such as an implementer, writes none and lists what it fixed in EVIDENCE.

The hook reads the report of a review or QA with one reader. It never reads a lower severity than you wrote, and it never reads a finding as none: a line that it cannot read makes the report unreadable. Start its RESULT with CLEAN, PASS, FINDINGS or FAIL; FINDINGS and FAIL need at least one finding. A finding is a line at any indent with a list mark, then the key, then the severity, with only marks around the severity (a colon, brackets, bold or a dash). The report is unreadable when a field is given twice (also FINDINGS as an indented line or a list item), when RESULT starts with another word, or when a line under FINDINGS is not none alone, a finding or indented detail under a finding. A line whose first or second word is a severity word, or that has a severity word with a colon after it (high:), is never detail. One severity rule covers the rest: when a line under FINDINGS has a severity word above the severity of its own finding, also in a sentence, the report is unreadable. A finding line and its detail compare with that finding, also when a higher finding is in the report; a lower word under a higher finding is detail. The hook reads the words high, medium and low, and critical, severe and blocker as high, as whole words in any case, also in full-width letters or with zero-width characters. Only quoted output in backticks or double quotes (saw: `not ok 3 a high finding is refused` ) and a word right after not or no (not a blocker) are text. So - K1 low a log, K2 high a crash is unreadable, and so are - K2 low a slow page (raise to medium) and steps: load a high row count under a low finding. The hook stops you once to fix an unreadable report, and names the line; a lead records no verdict from it: the sage reads it.

In a review or QA, each medium or high finding carries its proof, on indented lines under it: proof: <one command, run from the repository root of the head> and saw: <the one output line that shows the problem>, or for a screen proof: screenshot <path> and steps: <the url and the actions>. The command only reads, or writes only into your scratch folder; it runs no inline code, and git only to read. A proof check reruns it on a fresh copy of the head after the project's dependency install (such as npm ci --ignore-scripts), and drops a medium finding that does not show again. Put long output in a scratch file, and name its path. In a proof, saw or steps line, put output with a higher severity word in backticks. A low finding needs no proof.

Every claim has its evidence in the same report: the command and what it printed, or a screenshot. "It works" without a command or a screenshot is not evidence.

04 同仓库更多 Skills

erickb336
erickb336/sage-stack

writing-standard

Write at 80% of Simplified Technical English. Apply to any text an agent writes for a person: messages, reports, specs, findings, reviews, plans.

★ 2
erickb336
erickb336/sage-stack

sage

The state tool of sage mode: records tasks, routes, agent runs, findings, verdicts by head SHA and the user's gates in ~/.claude/sage/<project>/. Use in sage mode for every change of a task's state, and before any merge. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

sage-help

Help with sage: how to set it up, switch sage mode and autopilot, read the board, answer the chief's questions, pick a skill or a principle, fix a run that went wrong, and find where sage keeps its files. The user types /sage:sage-help (or /sage-help) with a question. Load it only when the user types it; do not load it on your own. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

remote-control

Set up Remote Control, so that the user can follow, steer and start Claude Code sessions from the Claude app on a phone. It turns Remote Control on for every new session, and it can run a server in a folder (such as ~/workspace) that starts at each login. Use when the user asks to reach sessions or start new ones from a phone, or to set up, check or undo Remote Control. Claude Code only.

★ 2
erickb336
erickb336/sage-stack

readme-guide

Write a project README. Apply when you write, change or review a README of any project, in any language.

★ 2
erickb336
erickb336/sage-stack

principle-type-system-discipline

Type system discipline. Apply when you design types, review a function signature or write code in a statically typed language.

★ 2