# 使用 AI 做项目的问题树与擎天价值分析

更新日期：2026-10-22。

本文从开发者与非专业用户使用 AI 推进真实项目时遇到的问题出发，整理问题树、具体表现，以及擎天当前能够提供的支撑。它为后续产品价值讨论、真实案例验证和宣传表达提供基础。问题来自本轮讨论与开发经验归纳，尚不是面向使用者群体的调研结论；七组共 23 项，也不代表已经穷尽所有问题。

非专业用户可能既不懂技术细节，也不希望学习或维护内部机制，但仍然期待好的、可使用的结果。这要求 AI 体系承担从澄清目标、组织工作、技术判断到验证、交付和维护的连续责任，尽量减少对用户专业能力的依赖。人的目标、价值取舍和必要授权仍由人决定；体系应把需要用户决定的事项解释为可理解的结果、成本和影响。

用户使用的编码 Agent 可能已经具备规划、Skills、自动化、工作区隔离等能力。擎天的定位是建设在这些现成能力之上的开发体系，减少组织工作、接续项目和维护方法的负担。具体边界见[愿景与定位](vision.md)。

## 问题树

```text
使用 AI 做项目时遇到的问题
├── 一、目标与交付：做出来的东西是否符合预期、真正可用？
│   ├── P01 理解偏了，写了很多才发现目标不对
│   ├── P02 只完成点名的部分，完整交付仍有遗漏
│   ├── P03 说“完成了”，却缺少可信的验证依据
│   └── P04 修好一处，又破坏了其它功能
├── 二、执行与推进：为什么还需要人一直盯着？
│   ├── P05 每次都要重复提醒同一批注意事项
│   ├── P06 卡住后重复尝试，缺少有效的策略调整
│   └── P07 长期任务依赖人反复启动、检查和安排
├── 三、上下文与经验：之前的工作为什么积累不下来？
│   ├── P08 换会话或中断后，需要重新解释项目
│   ├── P09 文档、代码和约定不一致，依据容易过时
│   └── P10 同样的错误反复发生，纠正经验没有被复用
├── 四、大任务与并行协作：任务一大、执行者一多就难以驾驭
│   ├── P11 大任务不知道怎么交，拆分工作又落回自己身上
│   ├── P12 多个 AI 同时工作，自己却成了调度员
│   └── P13 各部分分别完成，合起来却不一致、不能用
├── 五、接入与日常使用：为了用好 AI，还要维护多少东西？
│   ├── P14 新项目重复配置，已有项目升级也麻烦
│   ├── P15 项目一多，进度、产物和待决定事项难以掌握
│   └── P16 要学提示词、规则和流程，使用门槛仍然很高
├── 六、非专业用户的闭环委托：不懂技术，也希望直接拿到可用结果
│   ├── P18 只有想法，不知道该补充哪些需求
│   ├── P19 被问技术问题，无法判断怎么选
│   ├── P20 看不懂代码和测试，无法判断做好没有
│   ├── P21 一报错就只能求助，工作无法自行继续
│   ├── P22 拿到代码或操作步骤，仍然用不上
│   └── P23 上线后还要自己维护，无法放心持续使用
└── 七、时间与成本：增加的组织方式到底值不值？
    └── P17 流程和多 AI 增加耗时、费用，却看不清实际收益
```

分组按使用者感受到的问题组织。同一问题可能跨组关联：上下文缺失会影响任务接续，约定过时会造成并行冲突，流程可靠性则影响多个分组。非专业用户一组尤其关注：遇到上述问题时，用户没有专业能力接手，能否仍然完成闭环。下文按同一编号保留逐项分析；原有 P01—P17 编号保持稳定，新增 P18—P23 放在对应分组。

## 逐项分析与当前解决程度

当前程度分为三类：

- **有直接支撑**：已有针对该问题的具体机制或工具，可以说明如何使用；不等于已经证明人工负担下降或效果稳定。
- **部分支撑**：已有部分方法或资料基础，关键环节和实际效果仍需验证。
- **待突破**：仍是核心探索问题，当前不宜作为已经实现的效果对外承诺。

现有能力以[当前实现事实](current-state.md)为准；执行方法由 `payload/` 中的规则和 Skills 拥有，本文不新增执行约束。

### 一、目标与交付

开发者期待：交出的工作符合目标、没有明显漏项，并且有足够依据判断能否使用。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P01 理解偏了，写了很多才发现目标不对 | AI 很快开始实现，但对用户意图、约束或验收条件理解有偏差，直到交付时才暴露，产生大量返工。 | **部分支撑**：任务理解、目标与验收约定、设计核对可以提前暴露偏差。 | 复杂或开放需求下的理解质量、遗漏识别，以及后续实现能否始终保持原意，仍需真实案例验证。 |
| P02 只完成点名的部分，完整交付仍有遗漏 | 功能写了，但配置、数据迁移、文档、部署或边界情况没有处理；用户要逐项发现并补充指令。 | **部分支撑**：工作流与交付方法要求检查整体完成条件和未完成项。 | 能否主动识别未被明确点名、却影响使用的工作，不能仅靠一份清单保证。 |
| P03 说“完成了”，却缺少可信的验证依据 | 不知道是仅编译通过，还是实际操作过；也不清楚证据是否对应当前版本，仍需亲自重查。 | **有直接支撑**：验证方法、交付物与证据留痕、未完成项记录，为核查提供依据。 | 验证范围是否充分、证据是否有效、最终结果是否正确，仍需分别判断。 |
| P04 修好一处，又破坏了其它功能 | 修改围绕眼前报错展开，忽略相关模块、接口约定或历史兼容，造成回归。 | **部分支撑**：调查、影响分析、Review 和回归验证有对应方法。 | 复杂系统中的影响识别、测试覆盖与可靠执行仍需改进，不能保证每次修改都没有回归。 |

### 二、执行与推进

开发者期待：少一点反复提醒和催促，任务遇到变化或困难时仍能有效向前推进。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P05 每次都要重复提醒同一批注意事项 | “先看现有实现”“不要重复造轮子”“记得测试”等要求反复输入，用户漏提醒时，AI 也可能漏做。 | **有直接支撑**：项目规则、工作流与 Skills 保存和复用通用要求，减少重复编写指令。 | 保存了要求不等于 AI 稳定遵守；复杂流程的可靠执行仍是核心挑战。 |
| P06 卡住后重复尝试，缺少有效的策略调整 | 反复执行相似失败动作，或持续报告同一阻塞；用户要发现停滞并提供新思路。 | **待突破**：已有停滞重评方法可作为探索起点。 | 需要可靠识别无效重复，触发复盘、调查、换策略或必要求助，并验证是否产生实际变化。 |
| P07 长期任务依赖人反复启动、检查和安排 | 隔一段时间就要回来唤醒 AI、检查状态、决定下一步；新信息出现后也不会自然形成连续推进。 | **待突破**：已有任务接续、长期事项和周期职责的资料约定，可复用宿主调度能力。 | 调度不等于持续交付；仍需解决每轮状态核对、新信息获取、动态优先级、有效行动与合理等待。文档本身不会启动后台执行。 |

### 三、上下文与经验

开发者期待：项目可以顺畅接续，已有决定和纠错经验能够持续发挥作用。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P08 换会话或中断后，需要重新解释项目 | 之前为什么这样设计、哪些方案试过、做到哪里容易丢失，恢复工作需要反复翻记录和补背景。 | **有直接支撑**：项目 Wiki、任务状态、设计决定和证据为接续提供持久资料。 | 资料是否及时更新、是否被正确读取，以及恢复后的理解是否准确，仍需验证。 |
| P09 文档、代码和约定不一致，依据容易过时 | 项目越大，新旧规则越容易冲突；AI 沿用旧信息，用户也难判断哪份资料可信。 | **部分支撑**：区分权威资料、项目事实和任务记录，明确不同信息的维护位置。 | 自动发现过时内容、处理冲突并持续保持代码与资料一致，尚未完整解决。 |
| P10 同样的错误反复发生，纠正经验没有被复用 | 这次纠正后，下个任务或项目又重犯；人的解释和纠错投入无法积累。 | **部分支撑**：条件式复盘可将有效纠正沉淀到对应规则或方法，并通过版本化分发复用。 | 如何判断经验是否通用、避免累积无效规则，并证明复发减少，仍需验证；不等于已经实现自主持续进化。 |

### 四、大任务与并行协作

开发者期待：任务变大、执行者变多后，整体交付能力提高，自己的协调负担不会同步膨胀。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P11 大任务不知道怎么交，拆分工作又落回自己身上 | 不拆容易乱，自己拆又要先承担大量设计、依赖分析和任务管理；拆错后还要返工。 | **待突破**：已有大型交付流程与滚动设计方法。 | 怎样决定是否拆分、按什么边界拆、拆到多细，以及如何保持整体设计和验收，仍缺充分验证。 |
| P12 多个 AI 同时工作，自己却成了调度员 | 分配任务、传递信息、协调依赖、发现重复劳动都需要人；局部更快，整体未必更快。 | **待突破**：优先复用宿主已有并行执行与工作区能力。 | 还需解决任务选择、依赖协调、共享信息和交接成本，不能承诺增加 AI 数量就能提速。 |
| P13 各部分分别完成，合起来却不一致、不能用 | 文件修改、接口与数据假设、设计决定互相冲突；Git 合并成功，整体功能仍不成立。 | **待突破**：已有整体完成与集成验证的方法要求。 | 需要及时发现约定变化，处理冲突并验证整体行为；隔离工作目录只能覆盖一部分问题。 |

### 五、接入与日常使用

开发者期待：项目更容易接入、资料更容易找到，不必为使用 AI 再维护一套复杂系统。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P14 新项目重复配置，已有项目升级也麻烦 | 每个项目重新准备规则、Skills 和工作方式，后续更新还要担心覆盖专属约定。 | **有直接支撑**：安装、检查、升级和冲突保护，可复用共享方法并保留项目专属规则。 | 当前原生目录布局以 Codex 为目标；其它工具的自动发现需实际验证，升级冲突也可能需要处理。 |
| P15 项目一多，进度、产物和待决定事项难以掌握 | 需要逐个翻会话、找文件、问进度，才能知道当前状态、下一步和需要关注的事项。 | **有直接支撑**：只读大盘集中呈现项目资料、明确记录的推进、下一步、关注事项、产物、Skills 与项目知识。 | 展示依赖项目记录的准确性；不能因文档存在就认定任务正在运行，也不等于已形成自动调度与决策系统。 |
| P16 要学提示词、规则和流程，使用门槛仍然很高 | 想用好 AI，先要研究如何配置、组织和维护它，可能比直接动手还费劲。 | **部分支撑**：可安装的共享方法和统一资料入口降低一部分配置与查找成本。 | 非专业人员无需学习和维护内部机制、体系能够自我治理，仍是长期愿景，尚未证明实现。 |

### 六、非专业用户的闭环委托

非专业用户期待：用自己的语言表达想要的结果，由 AI 体系自主推进到可使用、可持续维护的状态，尽量不需要自己学习技术细节、组织流程、排查故障或维护体系。P16 关注的是学习和配置门槛；这里进一步关注缺乏专业能力的用户，能否真正把整件事交出去。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P18 只有想法，不知道该补充哪些需求 | 用户能说出“想做什么”，却不知道哪些使用场景、限制和异常需要说明；AI 等待完整需求，用户又写不出完整需求。 | **部分支撑**：任务理解与目标澄清方法可以用于询问和核对。 | 需要主动通过用户能理解的问题补齐必要信息，展示具体例子帮助确认，并区分可自行调查的信息和必须由用户决定的取舍。尚未验证非专业用户能顺畅完成这一过程。 |
| P19 被问技术问题，无法判断怎么选 | AI 把框架、数据库、部署方式等选择交给用户；即便有多个选项，用户也不知道各自会影响什么。 | **部分支撑**：设计与调查方法为技术选型提供基础。 | 需要在目标和授权内承担常规技术判断，把确需用户决定的问题解释为使用体验、费用或其它实际影响，避免要求用户先成为技术负责人。尚未形成经验证的非专业用户交互闭环。 |
| P20 看不懂代码和测试，无法判断做好没有 | AI 展示代码、测试结果或术语作为完成依据，但用户看不懂，也没有能力发现隐藏缺陷，只能相信“已经做好”。 | **部分支撑**：已有验证、Review 和交付证据方法。 | 需要让体系主动验证真实使用链路，以可体验的结果和清楚的限制帮助用户确认目标是否达成；不能依靠用户审查技术细节来兜底。当前尚未证明能够可靠替代专业检查。 |
| P21 一报错就只能求助，工作无法自行继续 | 遇到环境、依赖、权限或运行错误，AI 给出术语和手动排查步骤；用户既无法执行，也无法判断什么时候恢复。 | **待突破**：已有故障处理与停滞重评方法可复用。 | 需要自主诊断、尝试恢复并验证结果；确需账户操作或授权时，只请求必要且可理解的配合。当前没有覆盖这些情境的可靠自治恢复闭环。 |
| P22 拿到代码或操作步骤，仍然用不上 | AI 交付了源码、命令或一份教程，但用户不会配置环境、启动、部署或更新，实际目标仍未完成。 | **部分支撑**：完整交付方法要求落实适用的发布与使用验证。 | 需要按用户的真实使用方式交付可访问、可操作的结果，并在必要授权内完成相关步骤；当前擎天自身可安装，不等于已解决任意目标产品面向非专业用户的交付。 |
| P23 上线后还要自己维护，无法放心持续使用 | 产品或体系需要更新、修复和恢复时，仍要求用户处理技术问题、调整规则或维护知识；首次可用之后无法持续托付。 | **待突破**：已有升级、长期事项记录和方法维护的部分基础。 | 需要结合实际运行环境完成持续观察、异常恢复、适当更新和结果核验，尽量降低产品与体系自身对人的维护依赖；当前不具备通用的无人维护能力。 |

这组问题的验证要覆盖整段体验：非专业用户能否从表达目标走到使用结果，并在后续变化和故障中继续使用；同时记录中途需要多少技术指导、人工接管和持续照料。单独简化安装、增加教程或提供聊天入口，尚不足以证明已经实现普适易用与自治理。

### 七、时间与成本

开发者期待：增加的流程、资料和协作能换来实际收益，而不是产生新的管理负担。

| 问题 | 具体表现与影响 | 当前程度与支撑 | 尚未解决的部分 |
| --- | --- | --- | --- |
| P17 流程和多 AI 增加耗时、费用，却看不清实际收益 | 小改动也经过长流程，多个 AI 重复读取资料，token、等待和沟通成本上涨，最终质量却未必更好。 | **部分支撑**：已区分轻量任务与完整交付流程，允许按需加载方法和资料。 | 怎样根据风险、复杂度和收益选择流程、上下文及并行规模，需要真实数据；目前不能宣传已普遍证明更快、更便宜或质量更高。 |

## 与核心挑战的对应关系

问题树按使用者的处境组织，[核心挑战](core-challenges.md)按需要攻克的体系问题组织。二者是多对多关系，不要求用一个项目同时验证全部问题。

| 体系挑战 | 主要关联问题 |
| --- | --- |
| 大型任务组织：拆分、并行与集成 | P02、P11、P12、P13、P17、P18、P19 |
| 并行冲突协调：文件、接口、决策与状态 | P09、P12、P13 |
| 流程可靠执行：复杂方法怎样稳定落实 | P01、P02、P03、P04、P05、P10、P17、P20、P22 |
| 跨时间持续推进：唤醒、接续与动态安排 | P07、P08、P09、P15、P23 |
| 停滞后的策略调整：识别失效并引入变化 | P06、P07、P10、P21、P23 |

P14 的接入维护、P16 的使用门槛与 P18—P23 的非专业用户闭环委托，也对应愿景中的普适易用和自我治理；它们不能完全被这五类技术挑战代替。

## 从问题到可验证的用户价值

后续可围绕具体问题补充真实案例：用户原本需要亲自做什么，现成编码 Agent 已经能承担什么，擎天增加了什么，以及最终减少了哪些提醒、返工、解释或查找工作。对时间与成本，还要同时记录流程、资料维护、并行协调带来的新增开销。

已有工具和方法可以作为“如何使用”的说明；效果宣传应由真实结果支撑。优先从 P03、P05、P08、P14、P15 这些已有直接支撑的问题积累证据，再逐步验证部分支撑和待突破的问题。当前不据此直接形成面向所有开发者的效果承诺。

每项案例至少保留任务条件、使用过程、最终交付与证据、人工介入，以及适用范围。具体案例继续沿项目既有日志和验证记录保存，本文维护问题及价值判断；验证后再决定哪些适合成为官网的价值表达，哪些继续作为探索方向。
