Skip to content

docs: add agent workflow rules to AGENTS.md - #2157

Draft
yangkaa wants to merge 2 commits into
goodrain:mainfrom
yangkaa:docs-agent-workflow
Draft

yangkaa wants to merge 2 commits into
goodrain:mainfrom
yangkaa:docs-agent-workflow

Conversation

@yangkaa

@yangkaa yangkaa commented Oct 19, 2026

Copy link
Copy Markdown
Contributor

背景

准备让 Multica 里的开发 agent(Codex)自动修 bug、提 PR。现有 AGENTS.md / CLAUDE.md 讲清了代码结构,但缺少「怎么提交、怎么验证、什么时候必须停下来问人」这类流程规则,部分事实也已和代码不一致。

改动

  • 新增 Agent Workflow 一节(三个仓库内容一致):
    • 范围:一个问题一个分支一个 PR,只做最小改动。
    • 分支命名:fix/ 或 feat/ 前缀,推到本仓库(E2E 门禁只测同仓分支)。
    • 提交规范:72 字符、DCO 签名、不带 AI 署名。
    • 测试与 test manifest 的要求。
    • PR 模板,以及 run-e2e 标签的用法。
    • 必须先问人的情况:结构变更、接口契约、配置、安装与升级路径。
    • 禁止事项。
  • 每个仓库各加了 PR 前的验证命令和本仓库的高风险区域。
  • 修正了与代码不符的描述(具体见各 PR 的 diff)。
  • AGENTS.md 与 CLAUDE.md 保持逐字一致,和原来的约定相同。

验证

只改了文档。文中的命令、路径和 CI 规则逐条对照了当前 main 的代码与工作流。

Add the branch, commit, test, PR and E2E rules that AI agents must
follow when fixing bugs, plus repo-specific verification commands and
risky areas. Correct facts that drifted from the code.

Signed-off-by: yangkaa <catkin.ni@gmail.com>
Signed-off-by: yangkaa <catkin.ni@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant