菜单
Refines a Meridian user story in SQLite for implementation — deepens Approach, architecture refs and tests. Use between /create-us and coding.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | refine-user-story |
| description | Refines a Meridian user story in SQLite for implementation — deepens Approach, architecture refs and tests. Use between /create-us and coding. |
| allowed-tools | Read, Glob, Grep, Bash, Edit, Write |
v11: persist with
update-us(stdin heredoc) only. Forbidden:.meridian/drafts/,us-*-refine.md. Refine = same SQLite row viaupdate-us→set-ready.
| File | When to read |
|---|---|
.agent/references/templates/writing-guide.md | Approach depth |
.agent/references/templates/code-quality-at-us-time.md | Mandatory |
references/refine-checklist.md | Mandatory |
references/us-template.md | Full structure |
| Target US | meridian_delivery.py show US-XXXX --full |
docs/05_architecture.md, docs/04_principles.md | Refs + DRY/SRP |
python3 .agent/scripts/meridian_delivery.py show US-0115 --full
python3 .agent/scripts/meridian_delivery.py update-us US-0115 <<'EOF'
(full US markdown)
EOF
python3 .agent/scripts/meridian_delivery.py set-ready US-0115 --ready true
Never Write docs/us/. No generate-board-json — upsert records board_snapshots.
When checklist passes and ready: true, the US moves to 📌 Todo on the board while status stays ❌ until implement/close.
--full, architecture sections.update-us US-XXXX (stdin) with ready: true in frontmatter only when checklist passes.prepend-decision if scope changed.US refined:
ID: US-XXXX
Ready for implementation: yes | no
Approach explanatory: yes | no
Architecture § exact: yes | no
Blockers:
Next: /implement-us US-XXXX
Creates a Meridian user story in SQLite after epics and versions exist. Use when adding work to the backlog with concrete acceptance criteria.
Gates implementation of a Meridian user story — verifies ready true, Plan, deps and architecture refs before product code. Use with /implement-us US-XXXX.
Maintainer procedure to add or change Meridian kit artifacts — skill, agent, workflow, routing, and every registry surface. Use when extending the harness, creating /investigate, or onboarding a new slash command.
Closes a Meridian sprint in SQLite after sprint review — fills Retrospective, sets status complete, logs decisions. Use with /complete-sprint vX-SY.
Closes a Meridian user story in SQLite after implementation — fills Record, acceptance, status. Use when marking US done or after /implement-us.
Creates a Meridian epic in SQLite after architecture is approved. Use when defining a new product capability before user stories.