fleet-comms

用途

fleet-comms 用于展示 CocoFleet 的调度（dispatch）与心跳（heartbeat）事件流，是一个只读的通信日志查看技能。其调用方式为 $fleet comms [fleet-id]。

主要能力

• 读取 .cocoplus/fleet/[fleet-id]/comms.log 并输出通信事件。
• 输出格式包含以下列：Time、Role、Instance、Event、Summary。
• 默认展示最近 50 条事件，按从旧到新的顺序排列。
• 支持可选过滤条件：
  • --role planner|producer|critic
  • --event dispatch|heartbeat|completion|blocker|signoff
  • --tail N
• 当未提供 fleet-id 时，自动选择 .cocoplus/fleet/ 下最近修改且包含 comms.log 的 fleet 目录。
• 对格式错误的行按跳过处理，并报告跳过数量。

使用方式

1. 首先验证 .cocoplus/ 目录是否存在。若不存在，输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
2. 解析参数 $fleet comms [fleet-id]。
3. 若未提供 fleet-id，选择 .cocoplus/fleet/ 下最近修改且包含 comms.log 的 fleet 目录；若不存在，输出“No CocoFleet comms log found.”并停止。
4. 读取 .cocoplus/fleet/[fleet-id]/comms.log。
5. 按指定格式输出，并应用用户请求中的可选过滤条件。

适用场景

适用于需要查看 CocoFleet 调度与心跳事件记录的场景，例如排查 fleet 运行状态、查看特定角色或事件类型的通信记录。

限制与安全规则

• 不写入 state.json 或 comms.log。
• 不通过此技能批准、恢复、暂停或停止 fleet。
• 将格式错误的行视为跳过输入，并报告跳过数量。
• 退出标准包括：显示所选 fleet id；从 .cocoplus/fleet/[fleet-id]/comms.log 读取 feed；在请求时应用角色、事件和 tail 过滤；不改变项目状态。