说出你要做什么
Agent 把一句普通的请求对应到一篇手册,并只在这篇手册的范围内行动。
| 你说 | Agent 从这里开始 | 做到哪一步 |
|---|---|---|
| 准备部署环境 | lifecycle/01-project-setup.md | 只做准备,不发布。 |
| 检查能不能上线 | lifecycle/04-pre-launch-checklist.md | 只检查;要修改前先说明改什么。 |
| 部署、上线 | lifecycle/05-production-release.md | 发布已核对的版本。首次上线时支付保持关闭或管理员测试模式。 |
| 部署后配置 | lifecycle/06-after-launch.md | 逐个模块配置和验收,不产生真实扣款。 |
| 还差什么? | site/checklist.md | 先确定哪些条目适用于本站,再按阶段逐项完成。 |
| 开放正式收款 | lifecycle/07-payment-live.md | 只在你明确要求时执行,并需写明商品、金额和渠道。 |
| 配置某个模块 | integrations/, operations/ | 只处理该模块。 |
| 撰写或审查公开页面 | seo-geo/on-page-seo.md | 只改涉及的页面,并引用所依据的规则。 |
告诉 Agent 你要什么,手册告诉它怎么做。
编码 Agent 读手册、改代码、跑命令,并记录做过什么。部署前会停下来问你,也从不经手你的密钥。
Agent 读取 AGENTS.md,把站名和文案写进站点配置,然后跑测试。
从环境准备到正式收款的七个阶段
每个阶段有自己的手册和明确的完成条件。
- 01环境准备列出本站资源、身份、配置与缺口,未发布项单独列出。
- 02开发交付核心任务、页面、响应式、权限及对应检查都有证据。
- 03SEO 与 GEO核实并修复页面清单、公开 HTML、语言与发现机制。
- 04上线前部署前项目通过,线上项目待部署后处理,保持关闭的业务范围明确。
- 05生产发布指定版本经受控流程发布,线上版本与业务另行核验。
- 06部署后逐个模块真实验收,支付模式按首次上线规则处理。
- 07正式收款在你给出的授权范围内核对真实交易、积分权益与最终开关。
它会在哪里停下来问你
读了手册,不等于获得了执行其中高风险步骤的授权。
- 每次部署都需要你同意。Agent 会先写明目标站点和完整的提交号。
- 新的生产 SQL 会先交给你审阅,再执行。
- 从不打印或保存密钥,只告诉你变量名和设置位置。
- 只在你要求时开放正式收款,从不自行发起真实扣款。
- 未经你同意,不清空或删除本地数据。
- 不动你启动的服务和数据库,自己启动的用完就关闭。
它会留下你能读懂的记录
Agent 对本站的了解写进 site/ 下的四类文件,随代码提交,不含任何密钥。下一个 Agent 或你自己都可以从这里接手。
| 文件 | 回答什么 |
|---|---|
site/profile.md | 这个站是什么:所有者信息和第三方平台上的非秘密资源 ID。 |
site/checklist.md | 建站做到哪一步:逐项状态,并链接到对应记录。 |
site/deployment.md | 每个环境里实际运行的是什么:版本、迁移、资源、哪些密钥已配置、站点开关和支付模式。 |
site/runs/YYYY-MM-DD-<task>.md | 某次执行做了什么:授权、目标、逐步结果、变更和阻塞。只新增,不改写。 |
# After launch: Stripe test payments connected
- Time: 2026-11-18 09:30–10:05 (UTC)
- Agent: Claude Code
- Authorisation: "Set up Stripe in test mode"; not included: live payments
- Target: production, https://pixelforge.example, Worker pixel-forge, D1
- Source: a1b2c3d…, clean working tree
- Runbook: agents/integrations/payment-setup.md
## Results
| Step | Result | Notes |
| ----------------------------- | -------- | ---------------------------------- |
| Product credits-500 mapped | Passed | Stripe price ID saved in admin |
| Test connection | Passed | secretKey, webhookSecret: set |
| Admin test purchase | Passed | Order ord_8f2…, 500 credits |
| Live purchases | Not done | Outside this authorisation |
## Written back
- site/checklist.md: A9 → saved
- site/deployment.md: payment mode admin_test无论成功还是中途停止,pnpm release 都会自动写入记录并更新部署状态。截图和原始日志不进入 Git。
适用于你正在用的 Agent
Claude Code、Codex,或任何会读取 AGENTS.md 的 Agent。手册是 agents/ 里的普通 Markdown,人也可以照着做。