Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
47 lines (33 loc) · 1.69 KB

CONTRIBUTING.md

File metadata and controls

47 lines (33 loc) · 1.69 KB
Raw

Contributing to Agent-RPA

感谢参与 Agent-RPA。项目仍处于 alpha，所有功能变更都必须先与蓝图、现状规格和路线图对齐。

开始之前

  1. 阅读 README.md 的成熟度与已知限制。
  2. 阅读 AGENTS.md 的 I-1–I-6 不变量、验证门槛和 Git 卫生要求。
  3. 从 docs/blueprint/ 找到目标边界，并在 docs/roadmap/ 确认依赖顺序。
  4. 检查 openspec/specs/ 和相关活动 change，避免重复或越过尚未冻结的契约。

变更流程

非平凡能力变更使用 OpenSpec：

openspec new change <change-name>
openspec instructions proposal --change <change-name> --json
openspec validate <change-name> --strict

artifact 顺序是 proposal → specs → design → tasks。实现应严格对应 tasks.md；完成并验证后再归档。缺少真实 Chrome/站点条件的任务必须保留为明确 gate，不得用 fake/stub 结果替代。

提交前验证

gofmt -w <changed-go-files>
go test ./...
go build ./...
openspec validate --all --strict
make driver-cdp-license-check
git diff --check

涉及真实浏览器时，追加相关 integration/e2e 并在 PR 中写明 driver、Chrome 环境、目标站点和结果。不要提交运行数据、依赖目录、构建产物、凭据或个人信息。

Pull Request

PR 应说明：

  • 解决的问题与关联 change；
  • 关键设计取舍及不变量影响；
  • 用户/开发者可见影响；
  • 已运行的验证与未覆盖 gate；
  • 新依赖的必要性、许可证与回滚方式。

安全漏洞请按 SECURITY.md 私下报告，不要创建公开 Issue。