先让一个小任务跑通,再让整个项目连贯起来。
开始前准备项目事实
准备项目目录、运行说明、依赖版本、目标页面和错误复现步骤。已有项目先确认如何启动、如何测试,以及哪些文件不允许修改。
本地与云端环境应区分清楚。浏览器能够打开网站,只能说明对应预览服务可访问,不能证明模型接口、支付或生产部署也已就绪。
确认客户端与服务配置
根据自己的系统选择开发工具,核对安装来源、支持版本和实际使用的服务配置。客户端、模型提供方和本网站内容管理是不同层次,不应混用账号或地址。
接口接入先完成最小请求,检查认证、模型标识和响应结构。密钥仅放在受控环境中,不要粘贴到公开文章、截图或浏览器前端。
写一份可执行的任务简报
把目标、约束、相关文件和验收条件放在同一份简报中。下面的结构用于整理任务,不是可以直接调用的本站接口。
任务越具体,越容易判断是否完成。对于不确定信息,先要求检查并说明,再进入实现,避免把猜测写进产品逻辑。
json
{
"goal": "为文章增加分类筛选",
"scope": ["文章列表", "分类配置"],
"constraints": ["保留首页与页脚样式", "不修改套餐价格"],
"acceptance": ["分类可切换", "空结果有反馈", "手机端可使用"]
}实施与验证要保持同一范围
实现前检查现有组件和内容模型,优先沿用已有约定。完成后核对修改差异,运行对应测试,再实际打开页面检查交互与文字。
后台内容任务还要验证保存后刷新是否仍存在、前台是否读到新内容、历史版本能否恢复。不能只看编辑框里已经出现文字。
留下下一次可继续的起点
交付说明至少包含已完成内容、验证方法、预览入口和已知限制。保存源码、内容数据与启动说明,避免只留一个临时地址。
站内文档提供 SDK、接口与工具的初始资料,但实际服务地址、模型与权限仍需根据接入方确认。遇到问题时,带上脱敏日志和复现步骤再定位。