T3 Code 网页应用测试技能
在隔离的开发环境中启动、保留并测试 T3 Code 网页应用，包括浏览器配对认证和 SQLite 状态管理。
技能文档明确要求将配对 URL 视为密码，不复制到日志或响应中，并警告不要在测试中传递 --browser，以避免消耗一次性令牌。它指导使用隔离的 base directories，并避免触碰共享的 ~/.t3。SQLite helper 默认拒绝写入共享主目录，并在每次写入前创建备份。存在一些隐含的用户确认（例如，不明确要求用户批准破坏性操作）。因此，最高 25 分中扣除了 6 分。
指令相对自洽，但关键命令（如 'vp run dev'、'node apps/server/src/bin.ts auth pairing create'）在同级仓库中未经验证。文档承认了失败情况，并提出明确的恢复步骤，但无法通过静态审查确认这些命令确实存在且可用。因此，满分 20 分中，由于依赖未验证且缺乏基于测试的证据，扣除了 12 分。
技能针对明确的受众（在孤立环境中测试 T3 的代理）和明确的使用场景（开始、迭代、恢复令牌、检查数据库）进行了良好定义。它声明了明确的边界（仅限 web，不用于移动端），并提供了错误条件下的指导。但是，文档未提及中国网络可达性或对海外服务的依赖，这对 FollowSkills 用户是一个潜在问题。因此，满分 15 分中扣除了 3 分。
文档结构清晰，嵌套合理，包含参考文件，并包含示例和故障排除部分。它没有版本号或变更日志，维护责任未明确。代码仓库提供 MIT 许可证，但仓库处于早期阶段（'非常非常早' 预期有 bug）。因此，满分 15 分中扣除了 5 分。
该技能旨在完成启动、验证和测试 T3 应用的任务，提供直接可执行的步骤。由于是静态审查，无法验证其在所有情况下的确实有效性，且未提供代表其完成关键任务的直接证据。相关命令的未验证性也降低了实际完成任务的信心。因此，满分 15 分中扣除了若干分，且受静态限制影响。
仓库包含 CI 工作流和其他测试，但这些覆盖整个项目，并未明确覆盖该技能的特定路径。没有专门为检验此技能而存在的测试或证据。文档本身是主要的证据来源，但无外部队证据。由于静态审查，且缺乏独立验证，最终得分较低。
- 该技能依赖的 'vp' 工具及其命令未在仓库中直接验证，请在使用前测试或确认安装指南（README 中有安装说明）。
- 对于中国境内用户，所依赖的服务（如 T3 应用）可能无法直接访问，技能文档未提及网络可达性，建议先验证。
- 技能可执行敏感操作（如直接编辑 SQLite 数据库），虽然文档建议谨慎并在写操作前停止服务器，但请确保正确使用 --base-dir 参数以避免误操作共享数据。
- 此技能与仓库其他部分无直接关联证据，需谨慎评估其实际有效性和维护状况。
这个 Skill 能做什么，适合哪些场景？
该技能为 T3 代码库的网页客户端提供指导，使代理能够启动隔离的开发服务器，进行首次浏览器认证，并在多次对话中保留环境。它涵盖配对令牌处理、恢复消耗或过期的令牌，以及直接检查或种子填充 SQLite 状态。它强调环境生命周期管理，在人类审查完成前不进行拆除。该技能是包含四个技能的较大仓库的一部分，专门针对网页客户端。
它从仓库根目录运行命令，通过 vp run dev 启动完整的网页栈，可选的 --share 标志用于多设备访问。它读取开发运行器输出以确定服务器端口、网页端口、基本目录和配对 URL。它管理浏览器认证，使用一次性配对 URL 和令牌恢复命令。它使用 node apps/server/scripts/t3-sqlite-state.ts 检查和种子填充 SQLite 数据库，并对拆分令牌使用认证 CLI。它保留环境直至用户确认完成。
- 希望本地启动 T3 Code 网页客户端并确保其正常加载的用户。
- 需要通过一次性配对 URL 在受控浏览器中模拟首次用户认证的开发者。
- 在继续迭代实现时，希望调查或重置测试数据的代理。
- 需要在多个对话中保持开发服务器运行而无需重新启动的开发者。
- 希望为另一人准备隔离测试环境而没有配对令牌风险的测试人员。
- 需要恢复已消耗或过期的配对令牌以继续浏览器会话的代理。
这个 Skill 有哪些优点和局限？
- 提供严格的环境生命周期管理，防止过早清理。
- 包含安全的配对认证流程，保护一次性令牌。
- 通过隔离基础目录支持工作树安全状态隔离。
- 为常见失败（令牌到期、端口移动）提供故障排除指导。
- 包含用于测试的 SQLite 检查和种子填充的参考文档。
- 依赖外部工具 `vp` 和 Node.js，在未安装时可能需要额外设置。
- 仅聚焦于网页客户端，排除移动测试，需另一个技能。
- 该技能是新项目的早期阶段，可能不稳定且无公开文档站点。
- 无针对该技能的测试套件，操作可能随项目演变而改变。
如何安装这个 Skill？
该技能位于仓库 .agents/skills/test-t3-app/SKILL.md 中。整个 T3 Code 仓库由用户克隆或安装（例如通过 npx t3@latest），技能文件夹应放置在代理的 Agent Skills 标准位置。由于这是仓库的一部分，无需独立安装。需依赖 Node.js 和 vp 命令行工具。
如何使用这个 Skill？
触发词：当代理需要运行 T3 本地、迭代测试 UI 行为、恢复配对令牌、隔离开发状态或在 state.sqlite 中准备测试数据时使用此技能。示例提示：'开始 T3 网页开发服务器并设置隔离测试环境。' 然后按照说明使用 vp run dev 启动服务器，通过 get 配对 URL 进行认证，使用 t3-sqlite-state.ts 进行 SQLite 操作，并在任务完成前保持环境活跃。
这个 Skill 与同类方案有什么区别？
该技能是 T3 Code 仓库中用于网页测试的内置技能，与针对移动客户端的 test-t3-mobile 技能不同。它不是独立的第三方技能。