用途：这是 claude-night-market 仓库的操作运行手册，说明每个 make 目标实际执行什么、产物落在哪里，以及发布一个版本的准确顺序。资料基于 2026-07-02 仓库 v1.9.15 的 Makefile、scripts/ 和 .github/workflows/ 验证。除显示 cd 外，所有命令都在仓库根目录运行，Python 相关一律需要 uv。
主要能力：make test 全量跑插件测试（逐插件运行，失败时重跑详细输出）；make lint 依次执行 ruff format、ruff check --fix、再 format、bandit（会改动文件）；make typecheck 逐插件 mypy；make validate-all 逐插件结构校验（失败不会中断，退出码仍可能为 0）；make plugin-check 逐插件 dogfood 检查（超时 180 秒，同样软失败）；make docs-sync-check 检查文档与能力参考是否漂移；make supply-chain-scan、make validate-skills、make analyze-skills、make status、make clean。根 Makefile 为每个有 Makefile 的插件生成委托目标，如 make sanctum-test，等价于 make -C plugins/sanctum test。单文件测试需进入插件目录运行，例如 cd plugins/imbue && uv run pytest tests/unit/test_deferred_capture.py -x -q；根目录 pytest 不会跑插件测试。
发布流程：用 sanctum:git-workspace-review 做只读检查，确认在 <topic>-<version> 分支（不要从 master 发布）；先 dry-run 再执行 uv run python plugins/sanctum/scripts/update_versions.py 1.9.16，脚本会改写大量文件的版本字段；补 CHANGELOG 条目并保持 [Unreleased] 在顶部；更新 docs/api-overview.md 后跑 make docs-sync-check；开 PR 过关后合并；打标签用 /sanctum:create-tag v1.9.16，触发 cross-framework-publish.yml 生成四个 tarball 资产。ClawHub 提交发布后仍需手动运行 ./scripts/clawhub-submit.sh v<version>。
产物：htmlcov/、coverage.xml 为自动生成，不要手改；reports/skill-graph.json、clawhub/、bridge/openclaw/、bridge/a2a/、book/build/ 为本地或 CI 生成；trust-report.json 仅由 CI 在 push 到 master 时生成。
限制：make validate-all 与 make plugin-check 失败后仍继续并可退出 0，必须读输出而非只看退出码。部分插件强制覆盖率，单文件运行也会写覆盖率报告。mdBook 版本未固定（latest），上游发布可能无故破坏构建。环境搭建、变更分级、调试、配置、覆盖率纪律等分别属于其他技能，不在本技能范围。