用途:GAIT Session Tracking 是 NetClaw 的强制审计骨架,每个会话都必须由它记录,用于保存分支、回合与操作审计轨迹。
主要能力:通过 mcp-call 调用 GAIT MCP 工具。gait_status 查看当前分支、未提交变更与仓库状态;gait_init 以绝对路径初始化新仓库;gait_branch 创建分支(创建后不会自动切换,需再用 gait_checkout 同名检出并验证);gait_record_turn 记录回合,字段含 user_text、assistant_text、可选 artifacts;gait_log 查看提交历史;gait_show 看具体提交(HEAD 等);gait_pin 标记关键提交。
使用方式:会话开始创建并切出分支后验证状态;每个有意义动作后记录回合,assistant_text 建议包含采集数据、变更与验证结果三部分;会话结束显示完整日志。命令示例格式为 python3 $MCP_CALL "python3 -u $GAIT_MCP_SCRIPT" <工具名> '{...}',实际参数名请用 tools/list 核对,勿猜测。
适用场景:健康检查、配置变更、故障排查、NetBox 对账、拓扑/安全/路由等所有 NetClaw 技能的审计记录。
限制:分支、检出、初始化与回合写入会改动审计状态,超时后先用 gait_status/gait_log 确认是否已成功,避免盲目重试造成重复记录;传输层响应不代表成功,需检查 isError 与 ok。不要 squash 不可变审计历史,应改用 gait_record_turn 追加摘要。遇认证或连接错误先检查 GAIT_MCP_SCRIPT 是否设置有效;工具出错应如实报告错误信息,不得编造结果。