用途:本技能规定向 pydantic/pydantic-ai 仓库推送提交并推进 PR 的流程。推送只是循环的开始,只有 CI 全绿且没有任何评论未解决时任务才算结束。
主要能力:
- 撰写 PR 标题与正文。标题与模板规则见根目录 AGENTS.md;正文可见内容不超过 40 行(模板行与折叠的 <details> 内容不计)。功能或行为变更按“为何变更、新增公开接口、用户可见行为、验证、对现有用户的影响”顺序书写,并链接 issue;无新增公开符号时写 none,对现有用户无影响时写 Nothing。简单 PR 只写 issue 链接、简短摘要与测试计划。
- 用户可见调用链 diff:从公开入口到可观察结果使用一条 fenced diff 树,节点格式为 path/file.py :: Class.method() 或 path/file.py :: function(),用 └─ 缩进被调用者,折叠无关中间调用,目标 12 行内容,不超过 20 行。
- 标签:标题、正文与标签更新交给同一子代理,标题或正文变化时同步校正标签。运行 .agents/skills/pushing-commits-to-the-repo/label-catalog 取得目录文件路径;创建、重命名或更新仓库标签后加 --refresh 并提交刷新后的目录。类目标签需与 PR 目的一致(bug、feature、docs、chore、refactor),并按最终标题、正文与 diff 添加主题标签,保留 size、priority、review、自动化标签;除非用户要求,不创建或重命名标签。只应用一个包标签:pkg:core、pkg:harness、pkg:clai2、pkg:evals、pkg:graph 或 pkg:clai;仓库基础设施用 pkg:core。打标签需仓库 triage 权限(Pydantic 团队成员及其代理);失败时引用实际错误,不要臆断无权限。size 标签自动应用,无需设置。
- 机械性文本/数据刷新:不改变代码、运行时行为、CI 逻辑或实质政策(如目录行刷新)。此类情况跳过本地 pre-push-review 与额外实质审查派发,也不询问第二意见;CI 与托管审查仍会运行。
- 推送前:提交打算推送的确切状态,除用户指示外不留已暂存、未暂存或未提交内容。其他 diff 每次推送前运行 pre-push-review,处理所有发现并重复直到无发现;审查结论只属于其所读 diff,后续提交即失效,需对新 diff 重跑并说明覆盖的提交范围。不得对已打开 PR 分支强推,应推送后续提交。推送失败时阅读真实错误。
- 推送后循环:盯 CI 至终态,失败时诊断(自己的问题就修;已知 flake 或 main 上已存在则说明并给出证据)。逐条处理所有评论(机器人或人类):有效则修复并回复改动内容、点 👍;无效则具体说明原因(附代码证据)并点 👎;不得静默忽略,也不得无回复即解决线程。真实权衡需升级而非猜测:需维护者决策时留言背景、理由、待决事项、各选项利弊与建议,然后每 30 分钟轮询回复。
- 循环结束后可考虑深度 douwebot 审查:CI Review 在 CI 成功后自动运行;douwebot 仅在打上 douwebot 标签时用更强模型运行一次,发布行内发现与正式结论,结束后自动删除标签,不替代 CI Review。应最后应用,因为它不会在后续推送重跑。命令:gh pr edit <number> --add-label douwebot,需 triage 权限,失败时引用实际错误。已知拒审:PR 触及任意层级的 AGENTS.md 或 CLAUDE.md、CLAUDE.local.md、.mcp.json,或 .claude/、.agents/、agent_docs/ 下内容时,任务不审查即失败(防止 PR 修改审查者自身指令的安全守卫);作者有写或管理权限则跳过该守卫。此后重新进入循环处理新评论。
- 交回前:在 CI、评论与所选 douwebot 审查稳定后,派发未参与该 PR 的新子代理,给出 PR URL、关联 issue、当前 base...HEAD diff、最终测试状态、标题、正文、标签与完整目录,仅检查标题、正文与标签是否符合本技能与根 AGENTS.md,要求返回当前状态或精确更正(替换标题/正文、标签增删)。应用所有更正;已提交改动会重启推送后循环,仅 GitHub 元数据更改不会。替换后需再用另一新子代理复查,直到报告为 current 才交回 PR。
限制:资料未提供本技能的价格、平台或性能数据,也未给出完整使用步骤示例。