<< All versions

Skill v1.0.1

currentAutomated scan100/100
ashokraj2011/singularityflow/sflow-finalize

+3 new

──Details
PublishedNovember 16, 2026 at 06:30 PM
Content Hashsha256:24b5736d5cd52690...
Git SHAea398577fbb7
Bump Typepatch
Compare with v1.0.0
──Files
Files (1 file, 4.8 KB)
SKILL.md4.8 KBactive
SKILL.md · 25 lines · 4.8 KB

name: sflow-finalize description: Finalize a fully approved developer Story into an exact hash-bound packet for Product Owner spec-to-code review. disable-model-invocation: true agent: agent

metadata: version: "1.0.1"


Finalize a Story

<!-- 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. This skill is already loaded; never call the skill tool for it. Unless paused, continue below in this turn.

<!-- sflow-output-contract: deterministic-mutation --> Output contract: Let the CLI validate and mutate state; preserve its exact result, warnings, publication status, artifacts, and next actions. 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. Never show a person a hash, digest or commit SHA: name the step, its generation, its files. Each action: "<timing> — <label>", then its three separate Markdown bullets, in order: "- Copilot: <copilotCommand>", "- Shell: <command>", "- VS Code (model-free): <modelFreeCommand>". Keep returned routes exact; never apart from their label, on one line or in a table. Missing Copilot: "no verified equivalent"; missing Shell or model-free: "not available for this action". Never invent routes or make more calls for formatting. On a refusal read remediationPlan: run its first read-only step once and follow context.strategy; never retry an unchanged condition or edit an earlier phase to clear it. One returned automatic plan-hash action (such as sync) may run once, then re-enter once. 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. View each agentOutput.read range and need text file in one response at its exact issued path in .sflow/out/, unless this chat already read that path (same path, same bytes); other omittedFields are optional. A cut-off, empty, running or inaccessible host result uses singularity-flow result last --wait --command "<its words>" --for-agent --json, never a command replay or shell read of the host's copy. Recover read-size/range failures with returned readRequests/readRanges in your file-view tool's parameters; finish all required ranges and continue this task. Use exact pathCorrections; never guess paths. Real missing-file/permission errors retain their path, native error and owner recovery route; never recreate inputs or retry unchanged access. Read taskResume on entry: keep its operation ID, spent budgets and exact next step across chats; obtain fresh context and local paths. Before ending, honor taskCompletion: input reads, preparation and diagnostic tests alone do not complete authoring or review. Preserve human decisions and explicit single-step boundaries. <!-- sflow-execution-boundary --> Boundary: reuse entry ready/workId, cwd=repositoryPath, or as is from a non-Git (chat) folder: SFlow finds the bound checkout; never refuse or wrap for it; 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.

  1. Run singularity-flow finalize; it decides whether every step is settled (approved, or skipped by a workflow decision), so never pre-check it yourself. On refusal relay its findings or Incomplete: list with its Recover: commands, and stop.
  2. The command verifies a clean tree, the governed seed, parent and Story specification hashes, every phase artifact, approvals, quality evidence, model/token records, and exact source/test tree.
  3. Show the finalization packet path, commit, and push. Next: /sf-epic-review when the packet names an epicId, otherwise /sf-pr.
  4. Do not approve or promote the Story. Finalization changes delivery state to finalized_for_review; Product Owner review is a separate decision.
← v1.0.0All versions