菜单
Run the pre-publish validation gate for a new release. Use before `make publish` or Zenodo deposit. Takes a version argument, runs make release-check, validates CHANGELOG [Unreleased] is non-empty, verifies version strings align, and previews the Zenodo metadata sync.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Run one of the project's comparative benchmark studies (realistic, ablation, appraisal, comparative). Use when executing Pre-reg S2/S3 or running appraisal quality. Validates env, runs the make target, summarizes results, and prompts for evidence update.
Run the LoCoMo external benchmark (Pre-reg Study S1) end-to-end. Use when executing or re-running the AFT vs naive_rag comparison on LoCoMo10. Enforces dry-run-first, env-var check, background execution, and post-run evidence update.
Update docs/research/09_current_evidence.md after a benchmark study completes. Use after any bench-locomo, bench-realistic, bench-ablation, or bench-appraisal run. Pulls numbers from results.md, enforces DISCOVERY vs CONFIRMATORY framing, cross-references the pre-reg.
Build the paper + arXiv submission bundle. Use before arXiv upload or when preparing a workshop submission. Runs latexmk, produces paper/arxiv-submission.tar.gz, then validates all result tables against committed benchmarks/*/results.md.
Verify pre-registration integrity — no uncommitted edits to benchmarks/preregistration.md, and declared studies match produced result files. Use before paper building, release gates, or when resuming scientific work after a break.
| name | release-gate |
| description | Run the pre-publish validation gate for a new release. Use before `make publish` or Zenodo deposit. Takes a version argument, runs make release-check, validates CHANGELOG [Unreleased] is non-empty, verifies version strings align, and previews the Zenodo metadata sync. |
| disable-model-invocation | true |
| arguments | ["version"] |
| allowed-tools | Bash(make release-check*) Bash(make meta-check*) Bash(make sync-release-metadata*) Bash(grep *) Read |
Argument: $version (e.g. 0.7.0).
Never run make publish or make zenodo-draft before this skill exits PASS.
Validates the full pre-publish state before touching PyPI or Zenodo.
make release-check VERSION=$version
This runs: lint + typecheck + test + test-llm + bench-appraisal + preflight.
On failure: stop. Report which gate failed and what the error message was. Do not proceed until all gates pass.
The canonical version source is pyproject.toml ([project] version).
src/emotional_memory/__init__.py resolves __version__ dynamically via
importlib.metadata — do not grep it for the literal version string.
Run the canonical version scripts:
uv run python scripts/resolve_version.py
uv run python scripts/check_release_metadata.py
uv run python scripts/check_metadata_ssot.py
resolve_version.py must print exactly $version.
check_release_metadata.py validates pyproject.toml + CHANGELOG heading.
check_metadata_ssot.py validates CITATION.cff, codemeta.json, and
.zenodo.json against pyproject.toml as SSOT.
Any mismatch = FAIL. Fix with make bump VERSION=$version then re-run.
Read CHANGELOG.md. The ## [Unreleased] section must contain at least one
bullet under ### Added, ### Changed, or ### Fixed.
Empty [Unreleased] = FAIL. The changelog entry must be written before release.
make meta-check-local
Validates DOI, authors, and citation metadata are internally consistent.
make sync-release-metadata
Show what metadata would be deposited. Does not create or update any Zenodo deposition — review the output before proceeding.
All gates passed. Ready to publish v$version.
1. Build and publish to PyPI:
make dist
make publish # or: make publish-pypi-manual
2. Verify PyPI release (poll until visible):
make verify-pypi-release VERSION=$version
3. Create Zenodo draft and review:
make zenodo-draft # review in Zenodo UI before publishing
4. Publish Zenodo deposition:
make zenodo-publish DEPOSIT_ID=<id from zenodo-draft output>
5. Push HF Space:
make release-space
6. Tag and push:
git tag v$version
git push origin v$version