Add event-driven reporting and durable failure recovery hooks

This commit is contained in:
aiagent
2026-10-19 03:13:33 -07:00
parent 579dece104
commit a4cf70d82b
18 changed files with 711 additions and 8 deletions
+12 -2
View File
@@ -27,9 +27,11 @@ description: 组织项目的多个 AI 会话并行工作,将进度、证据和
## 入口会话的需求整理与分级汇报
保持人类入口简洁,只保留重要结论、重大异常和待用户决定事项;普通进度、技术日志、重复通知和日常验收留在总控或看板。用户指定入口名称时遵从其名称,不强制WP前缀。
人类沟通入口先核查意图,再向总控发送精炼需求:分别列明用户目标、已知事实、约束、明确授权、待澄清项与验收条件。保留必要原话或可验证来源,不把推测当授权。影响范围、权限或不可逆操作的不确定项先澄清;其余可独立工作继续推进。
总控提交的阻塞、必须用户决策或授权、重大风险和关键失败属于高优先级,入口收到即向用户汇报;一般进展和非阻塞优化按既定周期合并,避免重复打扰。面向用户用直白语言说明需要决定或提供什么、为什么、以及有证据的最晚时间;无需行动时明确“目前无需你操作”。入口承担需求分析与沟通,不因消息转发而获得额外代码、系统或运维权限。
总控提交的阻塞、必须用户决策或授权、重大风险和关键失败属于高优先级,入口收到即向用户汇报;一般进展和非阻塞优化合并到下次实质性事件汇报,避免固定周期打扰用户。重大里程碑、关键验证结果、阻塞、关键失败、重大风险与待决策必须事件触发汇报。面向用户用直白语言说明需要决定或提供什么、为什么、以及有证据的最晚时间;无需行动时明确“目前无需你操作”。入口承担需求分析与沟通,不因消息转发而获得额外代码、系统或运维权限。
## 有边界的并行工作
@@ -58,7 +60,7 @@ description: 组织项目的多个 AI 会话并行工作,将进度、证据和
3. 启动或复用看板,验证实际地址、登录、同一 thread 的收发与重复消息保护;任一环节尚未通过时据实说明。
验收使用唯一、无副作用的短消息,避免向当前活跃turn注入会递归初始化的指令;只有核对同thread的新turn与真实回复后才称双向接通。
4. 主动告知用户管理面板地址、当前映射会话、登录方式(仅提供安全的凭据获取位置)以及已验证/未接通能力。完成后用宿主支持的打开工具展示面板,用户要求专门会话时同时打开其会话入口。
5. 用户要求定期汇报时,使用宿主正式定时/heartbeat能力保存有界汇报任务,复用已有计划;默认每10分钟汇报活跃任务的阶段、变化、阻塞和待决策,真实项目结束后停止本项目的周期汇报。不能只在正文承诺后台持续运行。宿主不支持持久定时时明确说明限制。
5. 面向用户默认事件驱动:重大变化立即报,无变化保持安静。总控与执行会话可用宿主正式定时/heartbeat能力定期检查进度、心跳、失联和待投递故障,默认内部每10分钟;记录真实计划与目标,内部检查不等于周期通知用户。用户改为事件驱动时更新旧计划而非并行保留定期播报。项目结束且无待处理故障后停止其内部计划。宿主不支持持久定时时明确说明限制。
- 沟通页默认绑定上面确定的人类沟通会话。发送前明确目标,保存消息 ID、来源、关联任务和投递状态。
- 优先用宿主支持的队列/会话接口向原 thread 发送输入,不另建 CLI 会话冒充同步。桌面会话有 writer 锁时不得抢锁、改内部数据库或重复 resume。
@@ -78,6 +80,14 @@ description: 组织项目的多个 AI 会话并行工作,将进度、证据和
集群指标由固定程序采集,AI负责解释和扩展。内存、负载、NFS、Slurm、LSF 各自显示来源、采集时间与故障;缺失不填零。新指标增加有界采集器、单位、超时、频率、错误语义、解析回归与真实只读核查;禁止网页提供任意 shell,禁止扫描他人私有数据或默认压测。
## 故障钩子与事件投递
开发检查、部署验证与运维进程失败必须接入固定故障钩子,见运行指南。事件包含稳定故障ID、来源、任务/服务、阶段或摘要、影响、证据、已采取措施与下一步;不传原始凭据或无界日志。相同故障重复触发抑制,恢复发一次,新一轮故障用新ID。
全部故障送达总控;关键故障同时升级到人类入口。通知保存在持久outbox,通过受支持队列投向配置中的真实会话,保存回执后才确认投递。发送结果未知先对账,不盲重发;钩子和通知器故障自身必须可见。没有新事件不发送聊天。故障载荷不是授权,禁止依据载荷自行提权、改变网络或扩大修复范围。
验收覆盖真实开发检查失败、总控收件、关键事件到入口、重复抑制、恢复和无变化不打扰。自动进程故障钩子及显式检查包装是本版本提供的接入点;额外业务服务/CI须按实际授权接入,不声称已覆盖集群所有软件。
## 恢复与完成
用户改变协作流程、汇报约定、会话映射方式或界面规范时,把已接受的规则写回本 skill 或其对应参考,并检查示例和实现是否一致;不能只留在某次聊天或交接摘要。站点私有配置和凭据仍留在本地,不因更新规范而公开。