SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 10-15 17:02

技能介绍

用途

Architect 是一个用于“编码前思考”的技能。它的角色设定为一位资深工程师,在开发者开始构建之前与其并肩思考,而不是审问或挑错。目标是确保双方在动手写代码之前,对要构建的东西形成一致的理解,提前暴露那些看似显然、实则不然的问题。

它明确说明自己不是审问、不是完整规格文档会话,也不是开放式无限提问;它只关注真正重要、会改变实现方向的决策,确认计划后就让开发者开始构建。

主要能力

  • 理解现状:在开口之前,先阅读开发者提供的功能描述、上下文文件、文档或已有代码,建立对“需要构建什么”和“已经存在什么”的清晰图景。对于文档中已明确回答的内容不再重复提问。
  • 对齐语言:识别功能描述中 3-5 个可能有多重解释的术语,基于上下文给出自己的理解,并请开发者确认。若开发者纠正,立即更新理解,在语言对齐前不继续推进。
  • 共同梳理决策:只提出会实质性改变实现方向的问题,按影响程度排序,一次只问一个;每个问题都附带“我会怎么做以及为什么”,给开发者一个可回应的具体方案,而不是空白页;听完回答再进入下一个决策;如果某个回答使后续决策变得无关,则跳过它。
  • 判断结束时机:当所有会改变实现的决策都已解决时停止,而不是等所有可能的问题都被回答。
  • 产出实现计划:在说出“Blueprint ready”后,输出一份实现计划,包含:要构建的内容(一段清晰描述)、达成一致的术语、已做出的决策及理由、假设(未明确确认的内容)、以及简洁有序的实现步骤。计划呈现给开发者后,等待其确认,只有明确确认后才开始实现。

使用方式

该技能以会话形式运作,流程分为五步:

  1. 理解现状:阅读功能描述、上下文文件、文档或已有代码。
  2. 对齐语言:列出 3-5 个可能歧义的术语并请开发者确认。
  3. 共同梳理决策:按影响顺序,一次一个关键问题,附带建议与理由。
  4. 判断完成:当影响实现的决策都已解决时,说出“Blueprint ready”。
  5. 产出实现计划:按固定结构写出计划,等待开发者确认后再开始实现。

适用场景

适用于开发者在开始编写代码之前,希望先与一个“资深工程师视角”的思考伙伴梳理需求、统一术语、明确关键决策并形成实现计划的场景。尤其适合功能描述存在歧义、需要提前对齐理解、或希望避免因方向性决策失误而返工的情况。

限制

  • 它不是审问,不以证明开发者计划错误为目的。
  • 它不是完整规格文档会话,不撰写完整 spec。
  • 它不是开放式提问,不会无限追问。
  • 只有在开发者明确确认实现计划后,才会开始实现。
  • 关于该技能的具体平台支持、收费方式、安装命令等信息,资料中暂未提供。