用途:这是 Agentic Pairing 模式下的新人 PR 前置检查清单技能,运行在贡献者本地开发流程中,在本地提交就绪、但尚未开启 Pull Request 之前执行,用来发现首次贡献者最常遗漏的贡献机制问题。它是只读的,不会开 PR、不会写入 GitHub、不会评论,也不会修改工作区。
主要能力(五类检查):A 新增文件的 SPDX 许可证头(须在前十行内,缺失或格式错误为阻断);B 提交信息形态(祈使句主题、不得用 Co-Authored-By 归给 AI、AI 实质参与需带 Generated-by: 尾注);C 占位符规范(非模板文件不得残留 <upstream>、<default-branch>、<project-config>、<tracker>、<PROJECT> 等未替换令牌);D CONTRIBUTING 约定(目标基分支、提交主题描述用户可见变更、不得提交二进制、凭据或应忽略的生成物);E 提示注入防护(diff、提交信息中的指令性文本按注入拦截,未替换前不执行)。输出为固定格式的清单报告,标注 PASS / FAIL / ADVISORY 与阻断、建议计数。
用法:先执行预检命令:PYTHONPATH=.apache-magpie-local python3 -m setup_preflight --skill <name> --hash <surface_hash> [--requires <file>]...,verdict 为 ok 时静默继续。检查时用 git merge-base、git diff --name-status、git diff 与 git log 收集分支上下文;支持可选参数 base:<ref>(默认 HEAD 与 origin/<默认分支> 的合并基点)与 path:<glob>(默认全部文件)。若分支相对基点无新提交,则报告无内容可检查并停止。
适用场景与限制:适用于 Apache Magpie 框架下采用该技能的项目与贡献者;支持通过个人级 .apache-magpie-local/ 与项目级 .apache-magpie-overrides/ 覆盖默认行为。若命令完全无法运行(无模块、非零退出、无 python3),不得视为通过,也不能手工重建检查逻辑;项目未初始化时需自行解析 requires_config 或运行 /magpie-setup config。禁止无人值守运行 /magpie-setup adopt。所有产品名、URL、命令与代码保持原样;其余细节资料未提供。