菜单
Use when releasing @haklex/* packages or propagating published haklex versions into Yohaku, mx-core, mx-space, or related downstream consumers.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when writing Haklex articles with Markdown plus LiteXML, choosing the appropriate Haklex node for content, authoring LiteXML fragments, or converting a LightXML/LiteXML string or file into Lexical SerializedEditorState JSON, Markdown, or Static Render HTML via the `litexml` CLI.
Use when creating or modifying demo/ UI components — buttons, cards, panels, pills, inputs, badges. Reference for all component CSS classes and their exact specs.
Use when modifying demo/ UI — adding pages, components, or styles. Defines the monochrome visual system, layout patterns, and component conventions for the haklex demo site.
Use when adding or modifying colors, spacing, typography, or layout values in demo/ CSS. Complete token reference for the monochrome design system.
Convert Shiroi Markdown to Haklex Lexical JSON. Use when the user wants to convert a markdown file or string to rich text editor JSON format.
| name | release-orchestrator |
| description | Use when releasing @haklex/* packages or propagating published haklex versions into Yohaku, mx-core, mx-space, or related downstream consumers. |
| user_invocable | true |
End-to-end release procedure for the shared-version @haklex/* package family. This skill supersedes .claude/commands/release.md.
| Rule | Requirement |
|---|---|
| Autonomy | Infer release metadata from repository state. Do not ask for package lists, semver level, downstream branch, or confirmation unless a stop condition is reached. |
| Versioning | All @haklex/* packages share one version, read from packages/rich-editor/package.json. |
| Default mode | Use incremental unless invocation text contains full, 全量, or standalone all, or unless semver classification reaches major. |
| Publish set | In incremental, publish the tri-directional closure of changed packages, not merely CHANGED_PKGS. |
| Peer safety | Treat duplicate runtime copies of lexical, React, lucide-react, shiki, and @lexical/* as release-blocking defects. |
| Downstream | Update downstream default branches directly after validation. Do not open PRs unless direct push is blocked and the user confirms the fallback. |
| Destructive actions | Do not discard, reset, restore, force-remove, or silently overwrite user-owned changes. Preserve state and ask before destructive recovery. |
Read the relevant reference files before acting. If performing a full release, read all of them.
| Stage | Reference |
|---|---|
| Repository and downstream layout | references/repo-layout.md |
| Release mode, change detection, semver, peer audit | references/release-analysis.md |
| Publish-set closure, build, publish, registry polling, CLI smoke | references/publish-pipeline.md |
| GitHub release, downstream propagation, third-party pin reconciliation, smoke tests | references/downstream-propagation.md |
| Stop conditions, safe recovery, common mistakes, real-world anchors | references/failure-recovery-and-anchors.md |
flowchart TD
A[Clean haklex worktree] --> B[Find last release]
B --> C[Detect mode and changed packages]
C --> D{No releasable trigger?}
D -->|Yes| Z[Stop: report no package diff]
D -->|No| E[Classify shared semver bump]
E --> F{Major bump?}
F -->|Yes| G[Switch to full mode]
F -->|No| H[Keep selected mode]
G --> I[Peer dependency audit]
H --> I
I --> J[Compute publish set]
J --> K[Bump and build all packages]
K --> L[Publish selected set in topo order]
L --> M[Registry poll and CLI smoke]
M --> N[Commit, tag, push haklex]
N --> O[Publish GitHub release]
O --> P[Update downstream worktrees]
P --> Q[Install, dedup gate, typecheck, build, smoke]
Q --> R{All downstream green?}
R -->|Yes| S[Push downstream default branches]
R -->|No| T[Stop with preserved failure state]
Scripts are advisory automation for repeatable checks. They do not replace judgment, and they do not edit files destructively.
| Script | Purpose |
|---|---|
| scripts/release-context.sh | Derive LAST, local version, source changes, peer-drift triggers, catch-up triggers, and CHANGED_PKGS. |
| scripts/peer-audit.sh | Detect always-peer libraries under dependencies, internal @haklex/* peer pins using workspace:*, and divergent third-party peer floors. |
| scripts/publish-set.sh | Compute PUBLISH_SET for full or tri-directional incremental mode. |
| scripts/registry-peer-floors.sh | Aggregate non-@haklex/* peer floors from published registry manifests. |
| scripts/downstream-dispatch.sh | Emit downstream manifest rewrite rows for @haklex/* pins and third-party peer-floor reconciliation. |
| scripts/duplicate-runtime-invariant.sh | Assert a single resolved version for runtime-anchored libraries in a downstream worktree. |
| Phase | Action | Primary Reference |
|---|---|---|
| 0.5 | Detect incremental vs full mode | release-analysis.md |
| 1 | Pre-flight and releasable trigger detection | release-analysis.md |
| 2 | Shared semver classification | release-analysis.md |
| 3 | Peer dependency audit | release-analysis.md |
| 4 | Build, publish-set closure, topological publish, registry polling | publish-pipeline.md |
| 4.5 | @haklex/rich-litexml-cli binary smoke | publish-pipeline.md |
| 5 | Commit, tag, and push haklex release commit | publish-pipeline.md |
| 5.5 | Publish GitHub release | downstream-propagation.md |
| 6 | Downstream worktrees, pin rewrites, peer-floor reconciliation | downstream-propagation.md |
| 7 | Downstream smoke tests and duplicate-runtime invariant | downstream-propagation.md |
| 8 | Failure handling or direct downstream push | failure-recovery-and-anchors.md |
| 9 | Final summary | failure-recovery-and-anchors.md |
| Check | Command / Script |
|---|---|
| Last release SHA | git log --grep='^release: v' -n1 --format=%H |
| Context detection | ./.claude/skills/release-orchestrator/scripts/release-context.sh |
| Peer audit | ./.claude/skills/release-orchestrator/scripts/peer-audit.sh "$LAST" |
| Publish set | ./.claude/skills/release-orchestrator/scripts/publish-set.sh "$MODE" "$LAST" $CHANGED_PKGS |
| Bump | pnpm bumpp -r <patch|minor|major> --no-git --no-tag |
| Build | pnpm run build:packages |
| Publish one package | pnpm --filter @haklex/<pkg> publish --no-git-checks |
| Registry poll | until npm view @haklex/<pkg>@$NEW_VERSION version; do sleep 5; done |
| CLI smoke | npx --yes -p @haklex/rich-litexml-cli@$CLI_VER litexml '<p>x</p>' --format json --compact |
| GitHub release | gh release create "v$NEW_VERSION" --title "v$NEW_VERSION" --notes-file "$NOTE" --verify-tag |
| Duplicate-runtime gate | ./.claude/skills/release-orchestrator/scripts/duplicate-runtime-invariant.sh |
MODE=incremental but CHANGED_PKGS is empty.src/** change, no non-@haklex/* peer-range advance, and no registry catch-up trigger.gh is missing or unauthenticated before Phase 5.5.@haklex/* peerDependencies using workspace:*.origin/HEAD.