release-process

当用户要求更新 extract-agent 版本号、补 changelog、构建 dist、推送代码、或发布到 PyPI 时使用此 skill。只用于维护者发版，不用于日常 workspace 提取。

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/memect/phoenix --skill release-process

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

name	release-process
description	当用户要求更新 extract-agent 版本号、补 changelog、构建 dist、推送代码、或发布到 PyPI 时使用此 skill。只用于维护者发版，不用于日常 workspace 提取。

release-process 负责当前仓库的标准发版流程。

当用户表达以下意图时，直接使用本 skill：

版本号必须同步更新这 3 个位置：
- pyproject.toml
- src/xdev/__init__.py
- src/agentic_extract/__init__.py
docs/CHANGELOG.md 必须记录本次版本的主要改动
优先跑与本次改动直接相关的验证，不要求每次全仓
uv build 之后只发布当前版本对应的两个产物，不要直接发布整个 dist/
标准顺序固定为：更新版本 -> 验证 -> commit -> build -> push -> publish

git status
更新版本号和 docs/CHANGELOG.md
运行必要验证
git add 本次版本涉及文件
git commit -m "chore: release X.Y.Z"
uv build
检查：
- dist/extract_agent-X.Y.Z.tar.gz
- dist/extract_agent-X.Y.Z-py3-none-any.whl
git push
发布：

uv publish \
  dist/extract_agent-X.Y.Z.tar.gz \
  dist/extract_agent-X.Y.Z-py3-none-any.whl

发布 token 不要写入命令或文档；通过 UV_PUBLISH_TOKEN 环境变量、keyring 或交互输入提供。

常用命令：

uv run pytest -q tests/agentic_extract
uv run pytest -q tests/integration/test_suite.py -k export_skills
uv run ruff check <touched-files>

如果这次只改文档，至少确认命令、文件路径、版本号和链接都已更新。