sflow-explain
Explain one change, clause, test, line, gap or generation from cited, deterministic records.
SKILL.mdplugin/skills/sflow-explain/SKILL.md
GitHubExplain a change from cited records
<!-- sflow-copilot-pause -->Reuse a verified pause-aware entry supplied in this invocation before any mutation or selection change; otherwise first run singularity-flow session current --for-agent --json once; pause precedes Git. If paused: native Copilot, only /sf-pause off, never resume implicitly. Reuse binding/personalization.replyName; fresh operation checks/consent remain required.
Output contract: Use read-only CLI evidence, preserve warnings and ordered actions, and change nothing unless explicitly requested. Summarize artifacts with verified Markdown-preview links; never paste document bodies, code or diffs into Copilot. For code, list touched paths and observed added/deleted/created line counts; unavailable stays unavailable. Use existing evidence, not extra calls solely for display. Summaries, links and opened previews are not human review or approval. For every next action, honor returned commandGuidance in order: Copilot, Shell, VS Code (model-free) using modelFreeCommand; if absent, say "not available for this action". Missing Copilot: "no verified equivalent". Never invent routes. Run a check only when a returned field or command asks for it; never decide from a step's name, kind or route that it applies. A refusal saying a check does not apply to this step is not a blocker: skip it and continue. Act on a result's act first: its state, do routes and any ask. A bounded result names agentOutput.read ranges and omittedFields text files; read all in one response with your file tool. If your host saved a result to a file you cannot open, run that command again with --for-agent --json; never read the host's copy with shell tools.
Boundary: reuse entry ready/workId, cwd=repositoryPath; CLI/workItemRoot paths only; never $HOME. No duplicate lookup. Use exact CLI-returned paths. repositoryPath is command cwd, not a prefix for absolute file paths. Never rebase paths or strip .git/worktrees. Issued private/external files are exact exceptions to repository confinement, not wider read/write permission; writes still need authorization. Resolve relative paths only against their declared base. On failure, preserve the path and error; never search or recreate it.
- In the Boundary repository, use the first word of
$ARGUMENTSas the subject. Run exactly one subject command:singularity-flow explain --subject <SUBJECT> <REMAINING ARGUMENTS> --json. Never guess a missing--id,--path,--lineor--gen; ask the user for the exact value instead. - Relay the returned statements with their citation IDs, the
Needs attentionitems, availability reasons, theauthority: nonelabel and the next actions unchanged. Whensubject.statusisambiguous, list its exactchoicesand ask which one; when it isunavailable, relay its reason code. - Stop. Never read or summarize source files yourself, call a clause satisfied, call a change mergeable, treat a region association or a test tag as proof, infer who wrote a line, or perform any lifecycle mutation.