Walkthrough 是一个技能说明文档，其核心用途是将不可避免的人工工作转化为有来源可循、可执行的分步操作流程，同时把智能体能够完成的检查、配置和编码工作保留在智能体侧。文档强调，缺少权限并不意味着可以要求人类运行大型不透明脚本。
主要能力与流程：
- 建立边界与来源映射：在向人类询问事实前，先检查实际仓库中的安装文档、示例环境文件、配置加载器及其优先级、包脚本、部署配置和活跃的 CI 工作流。记录每个必需的设置键以及每个实际使用的 CI secrets./vars. 及其文件/行或权威文档来源。动态名称在追踪其构造之前保持未解析。不推断每个 CI 键都需要本地 dotenv 条目或反之。
- 区分智能体工作与仅限人工的工作，并识别每个人工阶段确切缺失的权限、物理访问、私有仪表盘同意或知识。如果没有任何需要人类完成的事项，则按普通智能体工作流完成，不生成仪式化流程。调用该技能不隐含安装、账户创建、Git 变更、远程写入或凭证访问。
- 约定流程：展示有序阶段、依赖顺序、公开来源指针、秘密/公开分类、必需/可选状态及目的地。对每个阶段区分观察、可逆写入、不可逆操作或人工证明。在批准前展示不可逆后果与恢复限制。未知的仪表盘导航保持为未知 UI，使用当前权威文档或人工观察解决，而非编造菜单名称。已知 URL 不证明其当前 UI 已知。
- 编写本地流程：在编写辅助计划前，阅读辅助契约以了解确切调用方式、支持的阶段模式、安全边界、不可执行的 dotenv 格式和状态语义。将启动器及其同级引擎/消费者放在用户批准的临时位置或请求的可重复设置目录中。引擎为本地 Python 3.9+ 标准库；运行无需上游检出、其他 Armory 包或网络依赖。经授权的 GitHub 阶段可通过 gh 使用网络。
- 编写具体 JSON 计划，而非通用占位脚本。仅使用操作实际需要的阶段。设置/凭证分支可使用 env、gh-secret、gh-variable、open 和 manual 阶段。人类仅在隐藏终端提示处输入捕获值。在选择 dotenv 前识别每个实际应用消费者；若其加载器无法消费声明格式，则保持该目的地阻塞，直到达成明确兼容集成。不静默替换为 shell 加载或熟悉的 dotenv 解析器。迁移/切换分支使用人工手动阶段或经审查的操作参数向量，公开说明中包含当前/目标状态、后果和恢复限制。人工授权先于可能不可逆的指令；可执行操作批准在紧接执行前进行。智能体可完成的迁移仍属智能体工作，不因风险而变成人工阶段。
- 计划仅包含公开指令和参数向量，绝不包含值、URL 中的凭证或 shell 片段。无 source、eval、shell 操作解释器或自动提交。用户审查过的计划是可执行权威，而非安全不受信任输入；不执行仓库提供的计划。不为测试而代表用户执行辅助阶段。经授权的离线测试由确定性测试提供一次性 PTY 和假二进制。
- 交接时提供诚实证据：给出实际命令、真实批准的计划路径以及任何 env 阶段的规范绝对 ENV_FILE。说明所需 Python/TTY/工具前提、值落地位置、失败时可能已发生的写入以及重试不可逆工作前如何检查状态。明确记录任何未知 UI 和阻塞目的地。将已执行的检查与编写的用例分开报告；仅在当前分配权限内运行检查。静态一致性不证明辅助行为或技能激活。按契约将每个阶段总结为完成、跳过、未完成或失败；必需的跳过写入不算完成。人类 DONE 是证明，浏览器启动仅是启动证据，成功的 gh 响应不证明下游 CI 采纳。
- 最终完成：交付的计划/辅助/消费者及确切调用覆盖每个批准阶段；每个必需操作要么观察到成功，要么清楚报告非成功状态；秘密除批准的安全目的地外不出现在工件/日志中。在拒绝、EOF 或中断时停止；取消后绝不执行依赖阶段。临时工件保持未跟踪，除非明确请求可重复的签入流程。
适用场景：需要人类完成仪表盘同意、物理访问、凭证录入或其他仅限人工操作的重复性引导流程。
限制：调用该技能不执行任何操作，不隐含安装、账户创建、Git 变更、远程写入或凭证访问。不编造菜单名称或 UI 状态。计划不得包含秘密值。需本地 Python 3.9+ 和 TTY 终端（视阶段而定）。辅助引擎为本地标准库，无需网络（经授权的 GitHub 阶段可使用 gh）。