配置目标:让协作可重复
真正有效的代码助手配置,不是写一段“请认真编码”的提示词,而是建立一套可复用的工程契约。助手进入仓库后,应能快速知道业务目标、不可违反的边界、事实来源、目录地图、测试命令和发布审批要求。
配置可以分为四层:
- 项目规则层:品牌、合规、架构和目录约束。
- 能力层:可调用工具、Skills、脚本和数据源。
- 执行层:规划、实现、测试、评审与收尾顺序。
- 证据层:任务追溯、测试输出、部署记录和人类批准。
项目指令应该包含什么
项目指令应短而可执行。关键内容包括:
- 当前项目目标与优先级。
- 明确的禁止事项和审批门禁。
- 权威事实与单一真理源。
- 任务到目录、脚本和技能的路由表。
- 文件修改纪律与验证命令。
- 对外发布、密钥和隐私规则。
如果规则只存在于聊天中,新会话就会失忆;如果所有细节都塞进一个巨大文件,检索成本又会失控。更好的结构是“入口宪法 + 事实地图 + 按领域加载的细则”。
Skills、Hooks 与子任务
Skills 适合固化重复方法,例如内容生产、SEO 实施和规范驱动开发。Hook 适合在会话开始、工具调用或提交前自动注入检查。子任务适合并行处理互不依赖的研究或验证,但必须由主任务汇总并承担最终责任。
选择原则:
| 机制 | 适合解决 | 不适合解决 |
|---|---|---|
| 项目指令 | 长期稳定规则 | 一次性细节 |
| Skill | 可重复专业流程 | 模糊临时请求 |
| Hook | 必须自动执行的检查 | 需要复杂判断的设计 |
| 子任务 | 独立研究与并行验证 | 共享大量可变状态 |
开发工作流
推荐使用以下闭环:
发现 → 规格 → 设计 → 任务 → 实现 → 自动测试 → 浏览器验证 → 部署复验每一步都要产生可以被下一步消费的证据。代码完成但没有测试,不能算完成;测试通过但生产路由错误,也不能算完成;部署成功但未经允许向外部平台提交,仍然越过门禁。
常见误区
- 只配置语气,不配置权限和完成定义。
- 让助手自行猜测事实来源。
- 工具权限过宽,缺少最小权限原则。
- 把“构建成功”误当成“用户场景通过”。
- 子任务结果无人整合,产生多个互相冲突的真理源。
实战检查清单
- 仓库入口文件能在五分钟内解释项目目标和红线。
- 事实、设计和实现各自有明确真理源。
- 每个常见任务能路由到对应 Skill 或脚本。
- 写操作前先读取目标文件并检查工作树。
- 新功能有类型、单元、集成和生产验证。
- 对外动作保留独立的人类批准记录。