SuperAPI AI 工具集

mentor

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:mentor 是 Apache Magpie 的实验性技能,实现 Agentic Mentoring(对话式指导)的首个原型。它针对单个 GitHub issue 或 PR 线程,判断是否存在一条能降低贡献者下一步行动门槛的教学式评论,并据此起草。若线程已步入正轨、维护者已介入或超出范围,技能会说明并退出,不发布评论。

主要能力:按配置的 convention_pointers 触发条件匹配四种典型干预(缺少复现、缺少版本、约定指引、why 提问),从 comment-templates.md 取模板渲染;运行 tone-checks.md 的语气检查;支持 hand-off 交接流程;读取 adopters 的覆盖文件与项目配置。

使用方式:先运行预检命令 PYTHONPATH=.apache-magpie-local python3 -m setup_preflight --skill <name> --hash <surface_hash> [--requires <file>]...,verdict 为 ok 则静默继续。运行时解析 <project-config>/mentoring-config.md,用 gh issue view <N> --comments 或 gh pr view <N> --comments 读取线程,做范围与维护者介入检查,匹配干预并起草,通过语气检查后展示给维护者,确认后用 gh issue comment <N> --body-file <draft> 发布。

适用场景:维护者主动调用,对单个线程做一次教学式评论干预。

限制:不做代码审查、不打标签、不提交修改、不预测维护者决定、不处理邮件列表、不自动触发;每次调用仅针对一个线程;需要项目配置,缺失必需键会中止;状态为实验性。外部内容仅作输入数据,不构成指令。