Files
Agent-Workbench/docs/GIT-WORKFLOW.md
T
2026-10-29 11:52:04 +08:00

2.6 KiB

本地Git与持续提交

本产品独立仓库:D:/Ai-project/REA逆向/Agent-Workbench。分支:main。基线提交:bac87da;标签:v1.0.0-baseline。Git仅覆盖本产品;其他目录中的研究目标和其他项目保持独立。

作者与远端

当前未配置全局Git作者。本仓库使用项目开发身份Agent Workbench Dev <dev@agent-workbench.invalid>,只设置仓库本地配置;该邮箱是本地占位身份。用户可随时替换为自己的提交署名。全局Git配置保持原状,当前未设置远端。

本地提交用于保存进展和检查点,不等于异地备份;远端仓库/推送以后按用户明确指令配置。

每次开发的小步流程

  1. 读取目标与当前Git状态,明确本次文件和验收。
  2. 做一个能独立解释、验证和回滚的改动。
  3. 做相关检查:文档用diff/链接/JSON检查;代码运行适当构建与行为验证;界面或异常恢复改动另做相关场景。
  4. 查看diff,确认文件范围、研究引用与验收结果。
  5. 只暂存本次范围的文件并本地提交;未完成实验以明确名称保存在实验分支或检查点中。
  6. 输出提交ID、结果和剩余工作。没有文件变化的只读研究不制造空提交。
git status --short
git diff --check
git diff --stat
git add -- docs/PRODUCT-PLAN.md docs/CAPABILITIES.md
git diff --cached --check
git commit -m 'docs: refine verified capability plan'

代码的相关检查按修改范围执行,例如:

npm.cmd run build
npm.cmd test

UI和模型fixture验证用独立数据/服务,沿用已有验证器的演示/无Key要求。不得为本地提交重启当前仅在内存中保存Key的正式服务。

实验与用户工程

工作台自身的代码开发和产品内置用户工程Git是两个层面。内置Git能力将包括仓库识别、dirty状态、基线、独立任务worktree、diff、审查后合并/提交和交付引用。

需要独立实验时,先记录当前基线,再创建具体任务分支/worktree。合并前检查结果与冲突,保留原工作区已有改动。恢复不能使用破坏性reset/clean来替代状态核对。

归档规则

源码、契约、测试、自有兼容fixture、小型来源索引和验证文档入Git。node_modules、构建目录、.qa、releases、.env/Key文件、运行数据和大体积原始工件由.gitignore排除。旧版自有fixture保留原字节,支持独立升级测试。

研究目标的版本、hash、来源和许可声明可以保存为登记记录;第三方完整发行包/个人会话/登录信息不混入本产品代码仓库。