Your setup guide is an untested surface. Make the tool drive the agent instead

说明与用途

用可测试的驱动程序替换手动说明，创建可靠的自动化安装向导，验证状态、保护机密，并使用低成本 LLM 进行渲染。

问题

Manual prose setup guides lack test suites, leading to fragile, error‑prone deployments that require human re‑execution after every change.

结果

Replacing prose with a testable driver script turns a fragile, human‑dependent setup into a reliable, automated wizard that verifies state, protects secrets, and uses only inexpensive LLMs for rendering.

工作流

• Write a driver script exposing currentRecord(state) and advance(state, answer) with injectable I/O.
• Define a record vocabulary (ask, do, say) with closed‑choice options.
• Implement verification functions that check credentials and attach recovery data to each step.
• Create a single npm script (e.g., npm run wizard:drive) as the sole entry point.
• Commit permission configs denying agent access to secret files by name.
• Add an AGENTS.md at the repo root to expose the driver to supported agents.
• Run tests with fake dependencies to ensure the wizard behaves correctly without live side effects.
• Deploy the wizard; the agent renders JSON records, collects user answers, and the driver validates and proceeds.
• Verify the final deployment with an end‑to‑end test purchase to confirm functionality.

证据

The wizard became a program. The agent runs one command, npm run wizard:drive, which prints exactly one JSON record.

来源

A record is one of three things: a question, a manual step, or a message to show.

来源

The agent never sees the secrets.

来源