open
Open a transaction: cut a tx-* branch off base, seed the repo, and route the change
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-11
- Stars
- ★ 14
- Forks
- 1
01 前言 Front Matter
- name
- open
- description
- Open a transaction: cut a tx-* branch off base, seed the repo, and route the change
- argument-hint
- [change description]
03 SKILL.md 正文
transaction(tx:open ~ tx:close)은 작업 단위가 아니라 무결성 경계다.
tx:open은 "지금부터 전체 상태를 무결하지 않게 만들겠다"는 선언이다.
Lifecycle
tx:open → tx:plan(변경 기록) → tx:apply(구현과 판정) → tx:archive(동결) →
tx:close(무결 선언, base로 squash merge). 모두 Skill 도구다.
close의 닫힌 상태 gate는 close 시점이 아니라 작업 내내의 규율이다.
열린 상태: 아래가 전부 참이면 transaction은 열린 것이다
-
A new branch
tx-<slug>is cut from the latestorigin/<base>and checked out. The slug is a short kebab-case name for the intent:"${CLAUDE_PLUGIN_ROOT}/bin/tx-hook" open-tx <slug> -
The seed has run (idempotent). Its artifacts ride this transaction and merge with it:
"${CLAUDE_PLUGIN_ROOT}/bin/tx-hook" seed -
The change is routed.
tx:plantakes anything that touches structure or worldview (the repo's design canon); a behavior-preserving refactor that touches structure is stilltx:plan's. Only two kinds of change skip openspec: one confined to the docs surface (${CLAUDE_PLUGIN_ROOT}/references/docs-surface.mddefines it), and one trivial enough to touch neither.
A failed command's stderr carries the fix; only a failed seed proceeds anyway, on the openspec-skip route.
04 同仓库更多 Skills
plan
Plan the change as OpenSpec artifacts: proposal, delta specs, design, tasks
git-sync-on
resume the paused git-sync guard
git-sync-off
pause the git-sync guard (resume with /tx:git-sync-on)
close
Close the transaction: archive, docs gate, then squash merge into base after CI passes
archive
Archive the completed change: task gate, delta sync into main specs, revalidate
apply
Implement the planned change task by task, then judge it