用途:在功能开发或重构开始前建立质量指标基线,便于后续质量门禁运行检测回归。适用时机包括新功能动工前、重构前记录初始状态、依赖升级或架构调整后,以及规划者创建待办、实现者开始任务 0 时。
主要能力:运行质量检查并解析五类指标——测试通过/失败/跳过数、覆盖率、类型错误、lint 错误、死代码数量,同时记录执行时间、git 提交哈希与时间戳,并将结果存入记忆系统形成基线实体。
使用方式:先准备功能名、git 提交与时间戳;运行 ./scripts/check_all.sh,失败时回退到 uv run pytest tests/ -v --cov=src --cov-report=term-missing、uv run pyright src/、uv run ruff check src/、uv run vulture src/;解析输出后创建名为 baseline_{feature}_{date} 的记忆实体,返回基线引用。
限制:需在编码前执行,不能事后补做;每个功能需独立基线;检查失败仍会记录但会标记警告;无 git 时跳过提交记录;脚本缺失且回退命令均不可用时中止;记忆服务不可用时改存本地 .quality-baseline-{feature}-{date}.json。执行时间通常约 8 秒,目标低于 30 秒。