Skill v1.0.1
currentAutomated scan100/100+4 new
name: sflow-epic-sync description: Synchronize an Epic lead branch and its registered Story repositories, then report exact repository and publication receipts. disable-model-invocation: true agent: agent
metadata: version: "1.0.1"
Synchronize an Epic
<!-- sflow-copilot-pause --> Before any boundary lookup or SFlow action, run singularity-flow pause status --json and follow its data.agentInstruction. If data.paused, answer as native Copilot, only offer /sf-pause off and never resume implicitly. 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. After a blank line, display each next action as three separate Markdown bullets, in order: "- Copilot: <copilotCommand>", "- Shell: <command>", "- VS Code (model-free): <modelFreeCommand>". Preserve exact returned routes; never combine them 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 further calls for formatting. <!-- sflow-execution-boundary --> Boundary: no Story required; cwd=opened Git root or verified repositoryPath from singularity-flow workspace current --json; refuse if neither resolves; never search $HOME/parents. 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.
- Resolve the Epic key from the argument or current branch.
- Run
singularity-flow epic sync <EPIC-KEY> --json. - Report every fetched repository, branch, commit, stale context, and pending publication.
- Stop only on a returned failing
results[].status, showing that repository; never force-push. - End with
/sf-epic-next <EPIC-KEY>.