ship-ipa-package
Prepare and verify npm releases of ipa-tools or ipa-prompt-api-fallback in inference-provider-api. Use for shipping a named package, preparing a version bump, or checking publication and its demo update. Questions about whether a release is needed call for advice, not publication.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 8
- Forks
- 1
01 前言 Front Matter
- name
- ship-ipa-package
- description
- Prepare and verify npm releases of ipa-tools or ipa-prompt-api-fallback in inference-provider-api. Use for shipping a named package, preparing a version bump, or checking publication and its demo update. Questions about whether a release is needed call for advice, not publication.
02 资源文件 1
- 参考文档agents/openai.yaml250 B
03 SKILL.md 正文
Ship an IPA package
Release only the package selected by the user. If the target is ambiguous, ask which package; never default to releasing both. Keep their versions independent. Use the current repository files and registry metadata rather than remembered versions or a previous release's commands.
| Package | Workspace | Versioned documentation and demo imports |
|---|---|---|
ipa-tools |
packages/ipa-tools |
Its README and matching ipa-tools@ imports in examples/** |
ipa-prompt-api-fallback |
packages/ipa-prompt-api-fallback |
Its README and the ipa-prompt-api-fallback@ import in examples/prompt-api-fallback/index.html |
Prepare and verify
- Work on an authorized feature or release branch based on current
main, preserving unrelated user changes. Read the selected package's manifest, changelog, scripts, and changes since its published version. A request to prepare or bump a version does not itself authorize publishing it. - Check
npm view PACKAGE versions --jsonand its dist-tags. Keep the current manifest version for a first publish if it is appropriate and unpublished; otherwise choose a SemVer bump from the published version. Use patch for compatible fixes, minor for compatible additions, and major for breaking changes. The spec's draft status does not reset package versioning. A failed registry lookup is not proof that a version is unpublished. - Update the selected manifest and root lockfile together. For example,
npm version VERSION --workspace PACKAGE --no-git-tag-version --ignore-scripts. Move applicable notes from[Unreleased]into a version section dated with today's UTC date, retaining an empty[Unreleased]section for future work. A prepared changelog entry is separate from confirmed npm publication. - Review the documentation and demo pins listed above. Update pins intended to demonstrate this release; leave historical migration notes and unrelated package pins intact. Keep the other package's version unchanged. Change a fallback peer requirement only when compatibility actually requires it.
- Use the root manifest's supported Node version and run
npm testfrom the repository root. It builds both workspaces before running tests and TypeScript checks, avoiding stale local peer output. Resolve failures before publishing. - Pack the selected workspace into a temporary directory with
npm pack --workspace PACKAGE --pack-destination TEMP_DIR. Inspect the packed version, exports, and files, then exercise the changed behavior using the packed artifact. For the fallback, verify it with a publishedipa-toolsversion satisfying its peer range, rather than relying only on the local workspace. Do not silently raise the peer requirement to make the check pass. - Run
git diff --checkand review the release diff. Follow the task's Git authorization for commits, pushes, and PRs. Keep a release PR in draft while its demo imports point to an unpublished or unavailable version. Create or push a release tag only when the user asks.
Replace PACKAGE, VERSION, and TEMP_DIR with concrete values. Give the user
paste-ready commands for the selected workspace, not unresolved placeholders.
Publish with the selected package's rules
ipa-tools: Preserve its existing user-publishes policy. The agent must not runnpm loginornpm publishfor this package. After preparation and checks, give the user commands to enterpackages/ipa-tools, runnpm login, and runnpm publish; wait for their response. Explain this skill requirement when handing off the publish step. If they request a publish dry-run, they run it.ipa-prompt-api-fallback: When publishing is part of the user's request, the agent may attempt one publish of the verified release. If npm requires interactive authentication (EOTP,ENEEDAUTH, or an authentication error), stop retrying and give the user the workspace-specificnpm publishcommand; includenpm loginonly if sign-in is needed. Do not automate login or bypass two-factor authentication. Preparation-only requests stop before publication.
Never read or print ~/.npmrc or auth tokens, or use npm whoami as a release
gate. Report name, ownership, or version conflicts without renaming a package or
changing access automatically. Do not run a publish dry-run unless requested.
Confirm publication and finish the demo update
- After a successful publish or the user says they published, query the exact
version with
npm view PACKAGE@VERSION version dist.tarball dist.shasum --json --prefer-onlineand check the intended dist-tag. Do not rely onlatestalone. - npm may report that an upload is processing before the version becomes readable. Keep any release PR in draft and retry read-only checks at 30-60 second intervals for up to five minutes. If still unavailable, report publication as pending and leave any release PR draft. Do not republish, bump again, or treat processing as an authentication failure.
- Verify the registry artifact matches the tested release. For changed CDN pins, fetch the exact entry URL and its resolved JavaScript and peer imports; a working wrapper alone does not prove the demo module is available.
- Once the version and all changed CDN imports resolve, update any release PR to describe the released version and validation, remove obsolete pending-auth notes, and mark it ready. Leave merging to the user's authorized Git workflow. After the user reports a merge, check deployment status and the import actually served by the live demo.
- Report the package and published version, install command, registry link, PR/demo status, and any remaining user action. Distinguish pending publication from a release confirmed available on npm.
04 同仓库更多 Skills
build-with-ipa
Build or adapt browser apps to use the Inference Provider API (IPA, window.inference) for user-approved AI inference. Use for IPA chat, tools, hosted search, images, or bounded speech in an app. Not for implementing a browser extension or other IPA provider.
ship-ipa-package
Prepare and verify npm releases of ipa-tools or ipa-prompt-api-fallback in this repository.
create-demo-og
Create or update matching Open Graph preview cards and social metadata for demo apps in the inference-provider-api repository. Use when adding an OG image or share preview to a demo under examples/, or refreshing one of these demo cards.