面向 Agent

编码 Agent 从搭建到正式收款照着执行的手册

SaaScaffold 在 agents/ 里附带 40 篇手册。告诉 Agent 你要什么:AGENTS.md 把它引到对应手册,手册写明要检查什么、运行哪些命令、在哪里停下来问你。

说出你要做什么

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,把站名和文案写进站点配置,然后跑测试。

从环境准备到正式收款的七个阶段

每个阶段有自己的手册和明确的完成条件。

  1. 01环境准备列出本站资源、身份、配置与缺口,未发布项单独列出。
  2. 02开发交付核心任务、页面、响应式、权限及对应检查都有证据。
  3. 03SEO 与 GEO核实并修复页面清单、公开 HTML、语言与发现机制。
  4. 04上线前部署前项目通过,线上项目待部署后处理,保持关闭的业务范围明确。
  5. 05生产发布指定版本经受控流程发布,线上版本与业务另行核验。
  6. 06部署后逐个模块真实验收,支付模式按首次上线规则处理。
  7. 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,人也可以照着做。

获取 SaaScaffold 源码

一次购买,填写 GitHub 用户名即可领取私有仓库的访问权限。

购买了解如何扩展