# Igapyon Miku Scm > Use only when the user explicitly names `igapyon-miku-scm`, explicitly asks to apply the miku SCM workflow, explicitly says `recommit` to invoke the miku-soft PR soft-reset recommit flow with implicit PR drafting, or explicitly asks to perform Git, GitHub writing, GitHub Release, repository-maintenance, or version-management work under miku-soft SCM rules. Supports PR, Release, About, and public GitHub Issue drafting; human-approved Issue and optional sub-Issue creation, title/body/existing-label updates, comments, standalone existing-label changes, and closure through narrowly documented `gh` workflows; PR soft-reset recommit; backup, branch-status, and three-stage local repository-maintenance workflows; date-based and Semantic Version increments; and READONLY version, tag, Release, and asset audits. Do not activate for generic Git or GitHub questions, ordinary repository inspection, or release-note writing outside an explicit miku-soft SCM request. - Skill: `igapyon/igapyon-miku-scm` (Agent Skill, multi-file: 109 files) - Install (CLI): `npx skillmds@latest add igapyon/igapyon-miku-scm` - Raw SKILL.md: https://api.skillmd.com/api/skills/igapyon/igapyon-miku-scm/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: igapyon (https://skillmd.com/u/igapyon) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/igapyon/igapyon-miku-scm --- # igapyon-miku-scm Run documented miku-soft source-control workflows with a small runtime context. Detailed policy remains under `references/` for design, maintenance, legacy operations, and exceptions; migrated workflows execute through the fixed runner. ## Current Scope Support repository status and maintenance; PR, Release, About, and Issue work; recommit, publication, backup, and post-merge work; version and release audits; and deterministic READONLY, preflight, and apply workflows. ## Activation-Only Fast Path If no concrete SCM task is given, acknowledge activation and ask what is wanted. Do not inspect the repository or load detailed references yet. ## Runtime Kernel 1. Identify the exact repository and classify the request with [scripts/miku-scm-workflow-manifest.mjs](scripts/miku-scm-workflow-manifest.mjs). 2. For an ID in that manifest, invoke [scripts/miku-scm-run.mjs](scripts/miku-scm-run.mjs) directly with that ID and fixed options. Resolve that runner path relative to the directory containing this `SKILL.md`; never derive it from the target repository name or `--repo`, which identifies only the workflow target. Do not read its detailed Markdown during normal execution. Prefer human output for a mechanical workflow when no structured field is needed for a subsequent step. Because `--format` is a runner-global option, always place it before the workflow ID: `node /scripts/miku-scm-run.mjs --format human [workflow options]`. Never place `--format` after the workflow ID. Return the runner's `human_output` unchanged instead of paraphrasing it. 3. Treat a bare `recommit` request as the PR Soft Reset Recommit workflow with an implicit PR-writing request. The user does not need to say `PR` separately. Resolve the base first and draft from exactly `..HEAD`. If no matching saved PR draft exists, collect `writing.pr.prepare` evidence, draft and save the PR text, then continue to `pr.recommit.preflight`. For an ordinary PR request without an explicit target, prefer the complete branch range when the branch is two or more commits ahead of its resolved base; keep a one-commit branch as a single-commit PR. Explicit commits and ranges always win. This routing authorizes preparation only; preserve the explicit approval gate before the local history rewrite. Treat exact `pr recommit push` as the separate remote workflow. First run one READONLY `pr.recommit.preflight`. If it has any blocker other than `PR draft is unresolved or missing`, return that fixed stop without drafting or mutation. If it has a matching draft and no blocker, invoke `pr.recommit.push --base --pr-draft --apply` once. If the missing draft is its only blocker, run `writing.pr.prepare --target ..HEAD` once, draft once from that evidence, save it at the returned `suggested_draft_path`, then invoke the same fixed push workflow with that exact base and saved draft in the same user turn. The runner never invents PR prose; this Skill-only writing fallback supplies the reviewed artifact it requires. Its exact `push` token authorizes this bounded draft preparation and the fixed recommit-and-publication transition. Do not route bare `recommit` or `pr recommit` to it. Route exact `miku-scm git add commit` to `work.commit --apply`. When the current user request or current TODO heading identifies the work, pass that concise one-line title with `--message`; do not use the generic fallback. Omit `--message` only when no concrete title is available, or for a version-only change so the runner selects its deterministic version title. Then let the fixed runner stage all ordinary non-ignored changes, check, and commit without returning between successful steps. Do not reconstruct that Git command sequence. 4. For a current Issue status, backlog, or progress request, invoke `github.issue.read --list` once with its default Open state. Do not add a second `--state all` read merely to calculate an Open/Closed breakdown. Use `--state closed` or `--state all` only when the user explicitly needs closed or historical Issues, completion metrics, or comparison with a closed Issue. 5. Never issue `gh` directly. GitHub CLI access is allowed only inside the fixed bundled helpers. If no fixed helper or anonymous REST route exists, stop instead of inventing a command. 6. A READONLY result or preflight does not authorize mutation. Local rewrite, tracked-content change, remote mutation, deletion, tag change, Release publication, and version change each require the matching explicit request and workflow gate. Approval never transfers between workflows. 7. Before tracked-content mutation or an ordinary commit, inspect the current branch and worktree. Do not mutate a `-done` branch. Preserve unrelated changes. Operational drafts and workflows with their own branch checks keep those documented rules. 8. A standalone apply must consume the unchanged reviewed artifact and expected digest when its workflow defines one. In an exact ordered batch, a later mutation for the same Issue may use the fixed preflight helper to refresh only the snapshot expectations allowlisted by the batch contract after an earlier approved step succeeds. Its repository, Issue, operation, draft and digest, requested labels, close reason, duplicate target, and workflow contract must remain byte-for-byte equivalent. Never retry an unresolved mutation automatically. 9. Report inspected, changed, and pending work. Keep tag recommendation separate from tag mutation; normal tag handoff is GitHub's Release UI. 10. Route an exact `miku-scm pending` request to `github.issue.handoff.list`. After a reviewed Issue preflight, an exact `miku-scm approve` request routes to `github.issue.handoff.apply --apply` and still requires exactly one pending handoff. The legacy `miku-scm 承認` input remains accepted. 11. When the human supplies either a full handoff ID or the exact 12-character approval suffix shown by the preflight or pending list, route `miku-scm approve ` to `github.issue.handoff.apply --handoff --apply`, or route `miku-scm dismiss ` to `github.issue.handoff.dismiss --handoff --apply`. The fixed helper resolves a suffix only when exactly one pending handoff in the target repository matches it; otherwise it stops. Never choose, invent, or reconstruct a selector or reviewed apply arguments. These exact commands are fast paths and do not require loading detailed references. 12. Route an exact `miku-scm approve batch [...]` request to `github.issue.handoff.batch.apply`, repeating `--handoff ` in the exact human-supplied order and ending with `--apply`. Require two to twenty selectors that resolve to unique pending handoffs. Never infer membership or order from `all`, recency, Issue numbers, or prior prose. The fixed workflow validates the complete batch before the first mutation. For later mutations to the same Issue, the fixed workflow runs a handoff-free dependency preflight after each preceding success and accepts only allowlisted snapshot-expectation changes caused by the ordered sequence. Any semantic change, failed refresh, `not-applied`, `conflict`, or `unresolved` result stops every later handoff. Preserve a delegate `conflict` as a distinct terminal state. Mechanical workflows retrieve, validate, mutate, and render stable results. Writing mode is limited to evidence-based Issue, PR, Release, About, and comment prose. Route normal writing evidence collection through `writing.issue.prepare`, `writing.pr.prepare`, `writing.release.prepare`, or `writing.about.prepare`. Draft once from that structured evidence and the user's direction. After writing, return to a mechanical preflight; writing never authorizes mutation. The generated lock [scripts/miku-scm-workflow-contract-lock.mjs](scripts/miku-scm-workflow-contract-lock.mjs) binds each workflow ID, contract version, runner, normative spec, contract test, and SHA-256 pair. Runtime results expose the contract identity. The generated [references/workflow-contracts.md](references/workflow-contracts.md) is for human inspection; neither generated file is hand-maintained. ## Detailed Routes Read detailed references only for work that is not a migrated runner execution: - **Status, maintenance, backup, or standalone branch work**: `local-git-readonly.md`, `github-branch-status.md`, `repository-maintenance.md`, or the exact backup reference. - **PR, Release, About, URL, tag, or public inspection writing**: `github-writing-rules.md` plus the exact topic reference. PR Issue matching also uses `github-anonymous-readonly.md` and `github-issues-cache.mjs`. - **Issue drafting or migrated mutation**: `github-issue-rewrite-handoff.md` for writing judgment; route create/update/comment/label/close preflight and apply through their fixed runner IDs. Read the exact reference only for drafting, design, recovery, or an exceptional legacy invocation. - **Version/tag/Release audit, increment, add, or commit**: the exact `version-*`, `github-release-tag-handoff.md`, and `repository-precommit-checks.md` references required by that operation. - **Runner design, performance, failure paths, or contract maintenance**: `workflow-routing.md`, `deterministic-workflow-runner.md`, `performance-benchmark.md`, `runtime-and-test-suites.md`, `safety-cost-and-errors.md`, and `scm-rules.md` as relevant. Regenerate contracts with `node scripts/miku-scm-workflow-contracts.mjs`; verify drift with the same command plus `--check`. - **Legacy or exceptional behavior not encoded by a migrated runner**: read `scm-rules.md` and the exact workflow reference before acting. Use only this skill's integrated helpers while miku-scm is active. Do not silently synchronize or overwrite `igapyon-github-writer`. Apply `igapyon-repo-conventions` only when explicitly requested. ## Verification Separate target-repository verification from miku-scm source verification. For ordinary SCM work against a target repository, do not run miku-scm's own fast or full suite, or its workflow-contract drift check, merely because this skill is active. Do not probe the target repository or an installed skill location for a way to run those self-tests. Keep the fixed runner's own preflight, revalidation, postcondition, digest, approval, and attempt-record checks; those are workflow safety checks, not miku-scm source tests. Run only target-project tests that are relevant and explicitly requested or documented by that target repository, and report them as target-project checks. When changing miku-scm itself, including its `SKILL.md`, references, scripts, contracts, or tests under `skills/igapyon-miku-scm/`, use fast tests while iterating and the full miku-scm suite before handoff. After changing a migrated runner, normative spec, manifest contract mapping, or contract test, regenerate the contract artifacts and run the contract drift check. For every tracked change, run `git status -sb` and review the relevant diff. Do not revert unrelated changes.