메뉴
Stage selected files, write a Conventional Commit, optionally link a GitHub issue, and append a dated journal entry under docs/journal/. Use when the user wants to commit work and capture a local record of what changed.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Ask which skill or flow fits your situation. A router over the skills in this repo.
Implement a piece of work based on a spec or set of tickets.
Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker — edges as text in one file per ticket locally, or native blocking links on a real tracker.
Plan a huge chunk of work — more than one agent session can hold — as a shared map of investigation tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.
| name | commit-and-document |
| description | Stage selected files, write a Conventional Commit, optionally link a GitHub issue, and append a dated journal entry under docs/journal/. Use when the user wants to commit work and capture a local record of what changed. |
Deterministic flow. Execute steps in order; do not deviate.
Run and read via Bash:
git status --shortgit diff --statgit diff --cached --statSummarise: which files, what changed.
If the working tree is clean, stop and report. Skip the rest.
One-line message:
<type>(<scope>): <short, action-focused summary>
feat, fix, refactor, docs, chore, test, style, perfShow: proposed message, files to stage, files excluded (tests, docs, secrets). Ask via AskUserQuestion: "Commit with this message? (yes / edit / cancel)". On edit, accept the user's revised message verbatim and re-run detection (step 2.5) on it before proceeding. On cancel, stop and report.
Silent pre-checks via Bash first:
git remote -v — bail if no github.com remote.command -v gh — bail if gh is not installed.Detection on the proposed message:
Closes/Close/Closed/Fixes/Fix/Fixed/Resolves/Resolve/Resolved #N (case-insensitive)#N anywhereBranches:
AskUserQuestion "After commit, comment on issue #N and close it? (yes / no)". yes → {action: close, issue: N}.#N: ask "After commit, post a progress comment on issue #N? (yes / no / close)". Map to comment / close / none.Carry the result as issue_action (default none).
Stage explicit files with git add <file>... via Bash (never git add .). Exclude:
test/, tests/, __tests__/, spec/, specs/*.test.*, *.spec.*, test_*, *_test.*.env, credentials, tokens)Flag exclusions to the user.
Commit with the approved message via Bash. Capture the short hash via git rev-parse --short HEAD.
If issue_action is none, skip.
Otherwise build via Bash:
> *This was generated by AI during commit.*
Linked from commit `<short-hash>`: <commit subject>
Run gh issue comment <N> --body "<body>" via Bash. If action == close, then run gh issue close <N> (never --comment; comment first).
If either fails, report the error and continue. Do not abort. Do not close an issue you could not comment on.
Read .gitignore via Read. If no line matches docs/, append via Edit:
# Local documentation — never committed
docs/
Do not commit the gitignore change. If the user accidentally staged anything under docs/, unstage it via Bash (git restore --staged docs/<path>) and warn.
List docs/journal/ via Glob if present. If it uses a different date/file convention than the default below, follow its existing convention. Create the directory if missing via Bash.
Date via Bash with date +%Y-%m-%d. Create docs/journal/<YYYY-MM-DD>/ if missing. Write via Write to <HH-MM>-<short-slug>.md (kebab-case slug, 3–6 words from the summary). Template:
# <Commit summary>
**Commit:** <full hash>
**Short hash:** <short hash>
**Date:** <YYYY-MM-DD HH:MM local time>
## What changed
<2–4 sentences. Plain English, not a file list.>
## Why
<1–3 sentences on motivation, pulled from conversation context.>
## Notes for future me
<Gotchas/follow-ups, one paragraph max. Skip if nothing worth saying.>
Read git diff --cached --stat via Bash. If any staged path overlaps with a path referenced in .zoo-flow/CONTEXT.md, output exactly one line before "Confirm":
"Public surface may have drifted. Run /zoo-update-docs? (yes / skip)"
On yes → suggest /zoo-update-docs <area>. On skip → continue.
Report: commit hash + message, journal entry path, whether .gitignore was updated, and any issue actions taken. Close with: "All of docs/ is gitignored, so this entry stays local."
COMPLETION PROTOCOL: Your final text message is your return value. Output this summary, then STOP — do not call any more tools.
Before broad reads, locate relevant files/symbols with Glob, Grep, or targeted file reads.
Prefer targeted Read with line ranges or block reads once the relevant area is known.
Read full files only when structure, ordering, or surrounding context is required for correctness.
Do not re-read unchanged files; use prior findings unless the file changed.
Use git status --short, git diff --stat, and targeted git diff -- <file> rather than dumping the full repo diff at once.
git push, --amend, --force, or reset --hard.git status is clean, abort early.