技术负责人和架构师

开篇速查：推荐模型与工具

推荐模型：GPT-5.6 Sol、Claude Opus 5 或 DeepSeek V4 Pro。
理由：适合复杂架构、长链路 Agent 和高难度编码判断；ADR、契约和原型仍须用测试、基准与团队评审验证。
推荐产品：Codex、Claude Code、Cursor（本岗位涉及复杂开发、仓库或运行环境）。 常用工具：GitHub、代码搜索、ADR、架构图、OpenAPI、基准测试与 CI。 核对日期：2026-08-04；上线前再查厂商官方模型列表并用内部评测集验证。

历史依据：从 8,276 条用户消息中命中 38 条，精确去重后 19 条。以下工作方式优先针对这些历史任务和返工问题。

1. 历史记录暴露的问题

• 明确验收标准：7/19（37%）。
• 明确要求验证：14/19（74%）。
• 提供失败/复现证据：10/19（53%）。
• 出现“功能不可用/报错”类返工：5 条。
• 出现“再检查/再测试”类返工：3 条。
• 出现“继续/不要停”但退出条件不清：6 条。

因此本岗位的模板会把验证、证据和退出条件写进首轮提示，而不是等失败后补充。

2. 什么时候使用

• 从现有代码确定系统实际架构
• 跨前端、后端、数据、插件和服务器划分边界
• 大型重构、迁移和多阶段项目
• 确定稳定身份链路、数据流和故障策略

3. 责任边界

• 负责系统边界、技术决策、依赖和风险
• 用代码、配置和运行结果区分事实与愿景
• 不替所有岗位实现全部代码
• 不以漂亮架构图代替数据所有权和失败语义

4. 开始前必须提供

• 仓库、目录、README、配置和部署清单
• 业务流程、容量和可用性要求
• 现有数据表、接口和外部系统
• 必须兼容的旧行为
• 迁移窗口、预算和团队能力

缺少信息时，先从仓库、配置、运行状态和现有资料中查证。只有会改变业务方向、造成生产影响或无法安全推断的内容才询问。

5. 完整可复制提示词

你是本项目技术负责人。先审计现状，再给架构和执行计划；本轮不进行大规模开发。

业务目标：【内容】
现有仓库/服务：【路径或说明】
关键数据链：【从用户/设备/店铺/商品到订单等】
规模与可用性：【用户、QPS、数据量、RTO/RPO】
必须保持：【旧接口、数据、部署、业务不变量】

请完成：
1. 用文件、配置、表和运行入口证明当前架构。
2. 区分当前事实、目标状态和未确认项。
3. 定义模块边界、数据所有权、稳定主键和跨系统映射。
4. 给出关键时序：正常、重复、超时、部分失败、补偿和人工恢复。
5. 比较至少两个方案的复杂度、成本、风险和撤销难度。
6. 生成 ADR、接口契约、迁移策略和回滚点。
7. 把实现拆成可独立运行和验收的纵向切片，指定岗位与文件所有权。

最后输出架构证据、决策、风险清单和第一阶段入口。

6. 推荐执行流程

1. 先盘点真实代码和运行入口
2. 画系统上下文和关键数据链
3. 标出数据源、主键和所有权
4. 为同步、异步和外部调用定义失败策略
5. 对方案做容量、安全、成本和迁移评估
6. 用小型验证原型消除高风险未知
7. 生成可分配给岗位的实施计划

每一步都要留下可复核产物：文件、命令、截图、请求、任务ID、数据库记录、指标或决策记录。

7. 标准交付物

• 现状架构和证据路径
• 模块/服务边界和所有权
• 身份链路、数据流和时序
• 接口契约和不变量
• ADR与替代方案权衡
• 分阶段纵向切片计划
• 岗位任务、文件所有权和交接顺序

8. 历史中常见失败写法

• 把产品愿景图误当成当前架构
• 没有统一 ID，数据跨系统无法追溯
• 服务拆分很多但职责重叠
• 只写成功链路，没有重试、幂等、补偿和审计
• 让多个代理同时修改同一核心模块

修正提示词

当前结果未满足验收。不要整体重做，先按证据定位差距。

原目标：【目标】
原验收：【可观察标准】
实际结果：【截图/日志/请求/任务ID/数据库记录】
差距：【逐条列出】
必须保持：【已正确部分和接口不变量】

请先复现并说明根因，再实施最小修正。修正后重复原验证，并给出修改前后证据。未通过的项继续保留为失败，不要用“基本完成”代替。

9. 完成检查清单

• 目标、范围和不做项没有漂移。
• 关键假设已用代码、运行或数据验证。
• 成功、失败、空、重复、超时和权限路径已处理。
• 交付物可由另一人独立打开或运行。
• 验收命令/路径已实际执行并保留证据。
• 未完成项、风险和数据限制被明确列出。
• 下游岗位得到接口、不变量、文件和验证入口。

10. 交接模板

岗位：技术负责人和架构师
已完成：【内容】
证据：【文件、命令、截图、日志、任务ID、数据库记录或指标】
接口与不变量：【下游必须遵守】
配置/迁移影响：【内容】
未完成与风险：【内容、严重度、负责人】
下一岗位：【岗位】
下一步输入：【精确文件、环境、账号或任务】
禁止假设：【仍未知内容】

11. 实用组合技巧

• 仓库自动考古：让架构 Agent 读取代码、配置、数据库和部署文件，分别输出“当前真实架构”和“文档声称架构”，优先解决两者差异。
• 接口先行并行开发：架构 Agent 先冻结 OpenAPI、事件 Schema 和错误语义，前端使用 Mock、后端实现契约、QA 同时生成契约测试。
• 架构决策自动沉淀：每次技术选型让 Agent 自动生成 ADR，记录背景、选择、替代项、后果和撤销方式，防止几个月后重新争论。
• 高风险点先做验证原型：让专项 Agent 只验证最不确定的性能、第三方接口、迁移或权限问题，通过后再进入大规模开发。
• 按文件所有权并行：架构 Agent 拆任务时同时指定模块、接口和文件所有者，避免多个 Agent 同时修改同一核心文件。