Product
Platform
web
Users
需求设计报告面向研发总监,供探索性技术讨论与初稿评审使用。
Product Purpose
用易懂的单页 HTML 说明 AI Native 开发工作流:静态架构、基本流程、程序需求、调度中心、Agent 分工与生命周期、运行环境,以及持久卷与 RSI 机制。报告用于讨论方向与边界,不作为详细技术设计或编码依据。
Operating Context
当前仓库只有静态报告、流程 HTML、交互组件架构图和讨论记录,没有已运行的调度或 Agent 服务。当前 14 步流程:Lark 触发 Worker 创建迭代 / 卡片与澄清;人工流转后 Coding 建 Issue 写可编码设计;评论与标签回调驱动 Coding 开发 / 评审,PR 添加标签后执行 CI;成功由人手动合并,合并回调后 CD 部署,再回调创建 E2E 测试,回写执行状态、结论和报告;最后由人判断并手动调整需求卡片状态,不自动完成需求。
Capabilities and Constraints
现行代码平台为 GitHub,使用 PR(Pull Request);Issue / PR 流程标记采用标签(Label),不是 Git tag。CI 实现仍待选型,不默认采用 GitHub Actions;评审意见及历史讨论中的平台名称和合并请求术语也统一为 GitHub / PR,其他历史意见不因此变为已采纳结论。
以 Meegle 卡片内的需求描述与程序需求澄清为准,在澄清阶段明确需求效果、验收标准和测试标准,人工确认后作为后续修复基准;不再以两份需求附件齐备为前置条件。GitHub Issue 承载可指导编码的详细实现设计,本报告不代替该设计。
五类执行角色为 Worker、Coding、CI、CD、E2E。卡片人工流转、Issue 开工标签、PR 首次 CI 标签、CI 成功后人工合并、最终人工确认并调整卡片状态是五类人工动作。
CI 失败仅在同一 PR 内自动修复重跑,不创建修复 Issue / PR;每轮自动修复都启动多个新上下文 Agent,不继承原 Coding 对话和修复结论,依据同一份已确认标准、同一版本代码及失败证据,先独立分析再共同讨论,统一由一个 Coding 修改并推送,其他 Agent 分析和复核、不并行改代码。loop 内推送自动触发 CI。
第 11 条已确认:人工审阅 PR 后由有审批权的审核人添加指定 Label,调度中心校验后启动首次 CI,视为预合并检查而非已合并。GitHub 仓库 Triage 或更高权限可添加已有标签,仅指定 Reviewer 不会自动获得此权限;平台标签权限不替代产品 / 动作审批权。新推送只提示人工认可后代码有变化,不自动撤销此前认可,不要求 loop 每轮重新打标签、不重置失败计数。合并前仍核对实际待合并版本的 CI 结果,由人手动合并;Label 不等于原生 Review Approve,不绕过仓库保护。标签名称、提示方式、人工额外提交的 CI 触发及保护规则配置待设计,尚未实现或联调。
第 9 条已确认:需求效果、验收标准和测试标准不变;允许纠正测试实现或 CI / 静态检查配置错误,不允许删除有效断言、跳过应执行的测试或降低检查要求。涉及测试 / 配置时说明对应标准及不降低要求的依据,不再默认转人工;共识不代替执行验证、授权、平台保护或人工合并。每轮在原 Meegle 卡片留言记录争议与结论、修改依据、涉及内容、PR / CI 链接和验证结果。
同一 PR 累计第 3 次 CI 失败立即停止自动修复、回到人工触发与介入流程,包含首次失败;前两次失败后各允许一轮多 Agent 协作修复,不在第 3 次失败后追加自动修复机会,讨论或增加 Agent 不重置计数。成功后仍手动合并。人工介入后重启与计数重置待设计。
多 Agent 协作的数量与模型、讨论收敛及无方案处置、预算 / 超时、基准与代码版本固定及校验方式待细化;标准缺失或矛盾时不得由 Agent 自行改写,不把多 Agent 共识写成识别所有绕过检查修改的保证。
建设统一员工 IdP,关联 Lark、Meegle、GitHub 账号,配套权限服务判定产品、平台与动作权限;数字员工方案的 IdP 确定采用 Casdoor,凭证保管采用 1Password,具体对接仍待验证。旧文中的 Vault 表示凭证库职责,不据此承诺 1Password 原生提供任务级临时授权与撤销。
按阶段绑定实际授权人:需求提出为产品 PO;需求讨论、分析、编码方案为研发 dev;CI / E2E 可由有相应权限的 dev 或 tester 任一人授权,不要求双签。自动回调不提供员工授权,阶段授权记录来源与衔接待设计。
调度中心携阶段授权人的可验证身份凭据向 Vault 申请;Vault 向统一 IdP 及配套权限服务核验身份和目标平台权限,通过后发放限定产品、角色和任务范围的临时凭证,由调度中心分配给 Agent。不继承用户全部权限;Agent 直接执行授权操作及卡片回写,退出或环境回收时撤销,另设有效期兜底异常情况。不支持临时凭证的外部系统需通过受控工具等方式适配,不直接下发长期 token。正常空闲 RSI 学习输出后退出 Agent,再回收环境,历史和知识保留。CI 修复 loop 不等于 RSI。
会话复用暂定:一个产品对应一个 Lark 机器人,一个机器人服务多个迭代,一个迭代包含多个需求,以迭代为维度复用会话。具体研发流程还需研发总监确认,不视为已定案。
所有 Agent 执行环境必须采用 Sandbox;MicroVM / Container 实现、隔离配置与资源规格待选。Harness 在执行工具前强制核验任务 / 阶段 / 参数 / 资源和授权,MCP 服务端独立鉴权;需求澄清与编码不得执行对方专属操作。Sandbox 不等于工具全开或绝对安全。
调度中心在建立 Sandbox、运行 Agent 时配置必要的限时 MCP 授权;到期 / 撤销后不能继续访问受保护资源。shell 子进程、文件和网络旁路防护待设计,不将第 8 条视为已彻底解决。
Lark 消息卡片交互为设计要求,用于状态、授权范围、到期提示及必要人工处理;具体组件 / 回调 / 更新限制待官方核验与联调,不能凭卡片展示代替员工授权校验。
◇ 待定:调度中心拉起 / 转发 prompt 前调用独立审查模型,恶意或可疑结果拟汇报 Lark / Meegle。审查控制流程独立不等于模型免疫注入,仍有误判 / 漏判,也不能覆盖后续所有工具返回;失败策略、成本和合规待评估。
◇ 待定:本人任意可验证交互刷新人工活跃窗口;这只是候选口径,窗口、跨任务范围、续期及无人值守 Coding / CI loop 到期处置待其他 Agent 调研。未选定有限租约或立即停权,也未批准“完全授权”等于工具全开 / 无限续期。后续先对抗性审查,经用户确认再执行。
第 10 条已确认:共享 Memory / Skills 面向 Agent,存储形式不作约束;调度中心按会话进入回收流程的顺序统一排队,逐个安排对应 Agent 执行 RSI 并直接写回,不要求分支 / PR / 人工合并。Git 仍可作为存储选项,不走 Git workflow 不等于禁止 Git。唯一入口须通过实际写权限保证,不允许其他 Agent 绕过队列修改共享库;保留产品、角色和用户隔离。
调度中心设置定时器扫描 RSI 任务完成情况;学习 / 写回失败,或崩溃、强制回收造成中断未完成的任务,依据持久化历史与任务记录进入同一串行队列补跑。记录任务状态和写回结果,避免重复派工或重复写入已完成内容;无有效经验、无需更新也可正常完成。
正常 RSI 路径仍是学习与输出、写回完成后退出 Agent,再回收环境。扫描间隔、超时、重试上限、持续失败处置、任务记录与部分写入恢复待设计,不默认无限重试;补跑仅限 RSI / 共享库更新,不据此自动重跑 CI、部署等业务任务,不恢复过期权限。串行写入不保证知识一定正确。
Sandbox 具体实现、持久卷、共享库读写接口、知识读取 / 分发及其他未确定方案需明确标注待选型或待确认。
保留测试 CD Agent 作为阶段划分;CD 授权主体、UAT 是否由 Agent 操作,◇ 待总监确认。生产发布由人工操作 CI/CD 面板,Agent 不参与;不默认发放生产权限。
Vault 与 IdP / 配套权限服务的适配、调度中心自身认证、用户身份凭据、账号映射与撤销传播均待设计验证;不宣称已原生对接 Casdoor 或已完成联调。
静态架构展示 Lark、Meegle、Agent 调度中心、统一员工 IdP、Vault、GitHub、CI、E2E 环境,以及按产品划分 Memory / Skills 的知识库、Worker 环境和 Coding 环境;E2E 环境由 PR 合并回调触发分配,由 CD 部署后再测试。
独立简版流程图 HTML 只含节点和简要说明,不加入架构、需求表或 RSI 长篇内容;已有报告、流程详图、交互组件架构图同步维护。
E2E 执行状态和测试结论作为卡片进度,不等于需求完成;由人结合合并、部署与测试结果决定最终流转。Agent、调度中心不自动关闭卡片,也不得将失败写成成功;具体异常处置及生产上线仍不在本稿展开。
Lark 机器人消息采用 WebSocket 长连接;Meegle 插件监听事件经公网 HTTPS Webhook 接入中心,验签并可靠记录后 1000ms 内回 HTTP 200,以
data.idempotent_key持久化去重后异步处理。官方协议已核对,联调、并发去重、崩溃恢复、乱序和动作幂等仍待实现与验证;不与自动化 Webhook 协议混用。开工标签、首次 CI 标签、需求认可流转及最终完成均由调度中心以程序核验真实操作人和产品/动作审批权限;Agent / 自动化账号不算批准,未知、无权或校验失败不推进。跨系统身份映射及名单维护方式待设计;Webhook 事后校验不能替代上游原生权限,也不自动撤销既有流转。
单页 HTML 采用自包含内容,避免依赖外部资源。
Brand Commitments
报告标题为「AI Native开发工作流」。正文说人话,术语首次出现时解释,不把待定方案或研究参考写成已实现能力。
Evidence on Hand
README.md:已确认流程、职责与范围。AI研发流水线-流程图.html:研发交付流程图;共用底座.html:共用底座交互流水图,点击组件查看直接上下游、职责与权限边界,替换原独立 SVG。docs/memory-skills-session-history.md:历史、记忆、Skills 与 RSI 的讨论结论。docs/research/hermes-memory-skills.md:研究参考,不代表项目采用其实现。
Product Principles
- 明确区分已确认边界、暂定方案与待讨论事项。
- 保留人工审批及资源授权,不用自动化绕过控制。
- 卡片、代码系统、执行历史和知识各有权威来源,不互相替代。
- 让读者看懂流程与取舍,而非堆叠实现细节。