smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
222 lines
10 KiB
Markdown
222 lines
10 KiB
Markdown
# 复盘：六天能力图谱
|
|
|
|
<div class="mt-6 text-sm">
|
|
|
|
六天内容只有一条主线：让 AI 参与研发时，团队如何持续获得事实、控制范围、验证行为，并把可靠经验沉淀下来。
|
|
|
|
</div>
|
|
|
|
<div class="mt-8 text-sm text-center">
|
|
<div class="inline-block px-4 py-2 rounded-lg bg-blue-500/10 border border-blue-500/30">看懂项目</div>
|
|
<span class="mx-2 op-50">-></span>
|
|
<div class="inline-block px-4 py-2 rounded-lg bg-emerald-500/10 border border-emerald-500/30">组织上下文</div>
|
|
<span class="mx-2 op-50">-></span>
|
|
<div class="inline-block px-4 py-2 rounded-lg bg-amber-500/10 border border-amber-500/30">处理复杂业务</div>
|
|
<span class="mx-2 op-50">-></span>
|
|
<div class="inline-block px-4 py-2 rounded-lg bg-purple-500/10 border border-purple-500/30">沉淀团队资产</div>
|
|
<span class="mx-2 op-50">-></span>
|
|
<div class="inline-block px-4 py-2 rounded-lg bg-red-500/10 border border-red-500/30">进入工程闭环</div>
|
|
</div>
|
|
|
|
<!--
|
|
复盘的目标是让学员看到六天内容之间的依赖关系。后面的 Skill、Agent、CI 和资产治理，都建立在前面的事实、规则和验证能力上。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 1 天：先把陌生项目变成可追溯的事实
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 学到的动作 | 不能跳过的原因 | 交付物 |
|
|
|---|---|---|
|
|
| 找模块、入口与关键对象 | 不知道系统在哪里，就无法讨论改动影响 | 模块认知图、项目结构图 |
|
|
| 追认证、路由、权限和日志链路 | 后台系统的风险常在跨层调用关系中 | 调用链路图 |
|
|
| 区分代码事实、业务事实与推断 | AI 的流畅表达不等于项目真实行为 | 输出校验清单 |
|
|
| 写代码理解报告 | 让团队的理解可被交接和审查 | 代码理解报告 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">
|
|
项目理解必须回到文件、函数、调用关系和不确定点，不能停在泛泛总结。
|
|
</div>
|
|
|
|
<!--
|
|
第一天决定后续所有工作的事实质量。没有项目地图和调用链，后续的 Rule、Plan 和 Review 都会建立在泛泛理解上。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 2 天：把一次会话变成可复用的上下文与规则
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 学到的动作 | 解决的问题 | 交付物 |
|
|
|---|---|---|
|
|
| 用目标、范围、约束、输出、验收组织任务 | 避免 AI 泛泛回答和无边界修改 | 上下文组织清单 |
|
|
| 组合 @workspace、#File、#Code、#Web | 让检索从宽到窄、从事实到细节 | 上下文引用模板 |
|
|
| 先收集证据，再判断和给方案 | 切断幻觉和错误归因 | 证据收集 Prompt |
|
|
| 编写安全、编码、测试与前端 Rule | 让团队隐性习惯变成可执行约束 | rules.md v0.1 与检查单 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">
|
|
好规则不是“写得严格”，而是能说明何时触发、必须检查什么、不能做什么、如何验收。
|
|
</div>
|
|
|
|
<!--
|
|
第二天将个人 Prompt 技巧升级成团队上下文和规则资产。它直接为后面的复杂业务设计、Agent 边界和 Review 提供统一语言。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 3 天：从工具功能转向任务编排能力
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 学到的动作 | 关键判断 | 交付物 |
|
|
|---|---|---|
|
|
| 理解 Rule、Cue、模型和 Token 的位置 | 资源要匹配任务风险与信息复杂度 | 成本与任务匹配表 |
|
|
| 区分 Command、Skill、MCP 与 CLI | 高频输入、多步决策和外部工具不是同一问题 | 能力封装决策表 |
|
|
| 设计 Agent 分工 | 输入、输出、验收和停止条件都要明确 | Agent 分工表 |
|
|
| 使用 Browser、文档与 Plan | 先计划、再执行、再记录验证 | 前端验证清单与 Plan 检查项 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-amber-500/10 border border-amber-500/30 text-sm">
|
|
任务越复杂，越需要先把边界显式化，不能因为有 Agent 就跳过计划。
|
|
</div>
|
|
|
|
<!--
|
|
第三天的重点不在于背产品名称，而在于根据任务类型选择合适的封装和参与深度。复杂任务需要结构化交接，不能靠一个巨大 Prompt 解决。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 4 天：复杂业务先建立控制面，再讨论实现
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 业务难点 | 先产出的控制面 | 为什么不能直接生成代码 |
|
|
|---|---|---|
|
|
| 权限 | RBAC 矩阵、页面/按钮/接口/数据范围方案 | 角色与数据范围是业务事实 |
|
|
| 状态 | 状态流转表、非法流转清单 | 允许和拒绝路径都必须明确 |
|
|
| 审计 | 字段表、前后值、SOP | “记录日志”不足以保证可追溯 |
|
|
| 异常态 | 前后端行为与最小测试集 | 正常流程跑通不代表业务安全 |
|
|
| 看板 | 指标字典、接口契约和验收 | 数字必须有口径、来源和权限范围 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
|
|
复杂业务最危险的顺序是“先让 AI 写代码，再回头补权限、状态和审计”。
|
|
</div>
|
|
|
|
<!--
|
|
第四天强调控制面优先。AI 可以帮助生成初稿、发现遗漏和组织 Review，但权限、状态、审计和指标口径必须由人和证据共同确认。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 5 天：把可靠判断沉淀为可维护资产
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 资产 | 适合保存什么 | 不应保存什么 |
|
|
|---|---|---|
|
|
| Rule | 长期稳定、违反代价高的约束 | 一次任务的临时路径和猜测 |
|
|
| 任务上下文契约 | 输入、输出、证据缺口和停止条件 | 没有来源的项目事实 |
|
|
| Checklist / Template | 固定遗漏点和稳定输出结构 | 所有判断逻辑的重复副本 |
|
|
| Skill | 多步骤、需要证据和验收的工作流 | 只有一句指令的简单需求 |
|
|
| Agent / MCP | 稳定角色、权限边界和外部能力 | 未声明读写性质的工具连接 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-purple-500/10 border border-purple-500/30 text-sm">
|
|
资产化不是把聊天记录保存下来，而是把可复用的判断、边界和验证方式保存下来。
|
|
</div>
|
|
|
|
<!--
|
|
第五天的核心是区分稳定资产与运行时事实。资产必须有来源、适用范围、输出契约和验证方式，否则会把旧项目结论错误套用到新任务。
|
|
-->
|
|
|
|
---
|
|
|
|
# 第 6 天：让 AI 改动进入真实工程闭环
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 工程环节 | AI 可以辅助的工作 | 人必须负责的判断 |
|
|
|---|---|---|
|
|
| PR 与 Git | 归纳 Diff、生成说明、检查范围 | 改动是否该合入、如何回退 |
|
|
| Review | 发现风险、汇总证据缺口、生成问题草稿 | 问题是否成立、优先级与修复决策 |
|
|
| CI | 分类日志、关联配置与 Diff、建议验证命令 | 区分代码缺陷与环境处置 |
|
|
| 证据链 | 整理需求、实现、测试和边界 | 结论能否被当前证据支持 |
|
|
| 资产变更 | 检查引用、夹具和行为变化 | 权限和兼容性是否可接受 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-cyan-500/10 border border-cyan-500/30 text-sm">
|
|
AI 产出必须进入已有的工程审查、验证和责任体系。
|
|
</div>
|
|
|
|
<!--
|
|
工程闭环是六天课程的最终落点。AI 可以加快信息处理与候选方案生成，但合入、发布和责任不能被一句“AI 已验证”替代。
|
|
-->
|
|
|
|
---
|
|
|
|
# 六项能力必须形成闭环
|
|
|
|
<div class="mt-8 grid grid-cols-3 gap-4 text-sm">
|
|
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30"><strong>事实</strong><br><span class="text-xs op-70">代码、配置、日志和业务确认。</span></div>
|
|
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30"><strong>上下文</strong><br><span class="text-xs op-70">目标、范围、约束、输出和验收。</span></div>
|
|
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30"><strong>计划</strong><br><span class="text-xs op-70">影响范围、最小方案、风险和验证。</span></div>
|
|
<div class="p-4 rounded-xl bg-purple-500/10 border border-purple-500/30"><strong>控制面</strong><br><span class="text-xs op-70">权限、状态、审计、异常和指标。</span></div>
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30"><strong>验证</strong><br><span class="text-xs op-70">测试、CI、浏览器和人工观察。</span></div>
|
|
<div class="p-4 rounded-xl bg-cyan-500/10 border border-cyan-500/30"><strong>沉淀</strong><br><span class="text-xs op-70">PR、证据链、Rule、Skill 和资产库。</span></div>
|
|
</div>
|
|
|
|
<!--
|
|
这六项是课程的能力模型。后面的能力不能替代前面的能力：没有事实，计划会虚构；没有控制面，代码会遗漏业务边界；没有验证，资产会积累错误经验。
|
|
-->
|
|
|
|
---
|
|
|
|
# 六天里最应该避免的六种误用
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 误用 | 正确替代动作 |
|
|
|---|---|
|
|
| 让 AI 泛泛总结整个项目 | 指定入口、问题、范围和证据格式 |
|
|
| 把模型回答当作业务规则 | 区分代码事实、业务确认、推断与待确认 |
|
|
| 直接接受大范围代码生成 | 先审阅 Plan，选择最小可验证 Diff |
|
|
| 只隐藏前端按钮就认为有权限控制 | 验证页面、按钮、接口和数据范围四层边界 |
|
|
| CI 变红就修改业务代码 | 先定位最早错误，区分代码、依赖、配置和环境 |
|
|
| 把一次有效 Prompt 直接升级为团队标准 | 先验证适用范围、停止条件和代表性夹具 |
|
|
|
|
</div>
|
|
|
|
<!--
|
|
这六种误用贯穿整个课程。让学员记住它们，比记住某个具体产品按钮或命令更有长期价值。
|
|
-->
|
|
|
|
---
|
|
|
|
# 最终交付不应只有代码
|
|
|
|
<div class="grid grid-cols-2 gap-4 mt-7 text-sm">
|
|
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">项目结构、调用链与事实记录</div>
|
|
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">上下文包、Rule、Prompt 和检查单</div>
|
|
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">权限、状态、审计、异常与指标控制面</div>
|
|
<div class="p-4 rounded-xl bg-purple-500/10 border border-purple-500/30">Plan、Diff、测试、浏览器与 CI 证据</div>
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">PR 说明、Review、修复记录和未覆盖边界</div>
|
|
<div class="p-4 rounded-xl bg-cyan-500/10 border border-cyan-500/30">可验证、可维护、可演进的工程资产</div>
|
|
</div>
|
|
|
|
<div class="mt-8 text-center text-lg">代码是结果之一；可复用、可验证、可维护的工程资产，才能支撑长期协作。</div>
|
|
|
|
<!--
|
|
这页把六天各自的交付物收束为一套工程资产。它们能够随代码、PR 或项目知识库留存，帮助下一位维护者理解为什么、改了什么、验证到哪里。
|
|
-->
|