smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
126 lines
6.5 KiB
Markdown
126 lines
6.5 KiB
Markdown
# 模块 2：从案例判断资产边界
|
|
|
|
<div class="mt-6 text-sm">
|
|
|
|
资产化最难的不是给文件命名，而是把可长期复用的判断，与一次任务中的项目事实分开。
|
|
|
|
稳定约束可以沉淀；字段名、路径、权限码和未验证结论必须留在运行时输入中。
|
|
|
|
</div>
|
|
|
|
<div class="grid grid-cols-4 gap-3 mt-8 text-sm">
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">稳定约束</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">运行时事实</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">已知反例</div>
|
|
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">证据缺口</div>
|
|
</div>
|
|
|
|
<!--
|
|
逐字稿：资产化的第一步不是建立文件夹，而是先划边界。稳定的判断可以沉淀，当前项目的字段、路径、权限码和没有验证的结论不能沉淀。把两类信息混在一起，资产一旦换项目就会带着旧事实继续工作。
|
|
|
|
资产的第一道边界，是不把项目事实伪装成通用规则。字段名、路径、权限码、异常文案等信息会随着项目或任务变化，必须作为运行时事实重新核对。
|
|
-->
|
|
|
|
---
|
|
|
|
# 资产选型先看变化与风险
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 判断维度 | 信号 | 更合适的承载方式 |
|
|
|---|---|---|
|
|
| 约束变化频率 | 长期稳定，违反代价高 | Rule：明确必须项、禁止项与验收 |
|
|
| 任务输入变化 | 问法稳定，但每次事实材料不同 | 任务上下文契约：固定约束，替换运行时输入 |
|
|
| 漏检风险 | 风险项有限且常被忽略 | Checklist：让关键检查可以逐项确认 |
|
|
| 决策复杂度 | 需要多步读取、判断、交接和验证 | Skill：编排资产与停止条件 |
|
|
| 误解成本 | 正确做法容易被错误套用 | Example：保留正例、反例和适用边界 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-amber-500/10 border border-amber-500/30 text-sm">
|
|
同一条经验不一定只对应一种资产；选择依据是变化速度、误用风险和决策复杂度。
|
|
</div>
|
|
|
|
<!--
|
|
逐字稿：选择资产不能只看名称，而要看变化和风险。高风险且长期稳定的约束适合 Rule，任务事实每次不同但判断框架稳定时适合任务上下文契约，多个检查点容易遗漏时适合检查单。需要连续读取、判断、交接和验证时，才值得封装为 Skill。
|
|
|
|
这张表不再平铺定义资产类型，而是用变化与风险做选型。稳定而高风险的约束适合 Rule；不断变化的任务事实不应写死在资产中。
|
|
-->
|
|
|
|
---
|
|
|
|
# 公务用车案例能沉淀什么？
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 案例中的发现 | 不应直接沉淀为 | 更合适的资产 |
|
|
|---|---|---|
|
|
| 前端必填不能代替后端业务保护 | “取消原因不能为空”的全局 Rule | 状态变更必要信息后端保护 Rule |
|
|
| 分析时要同时看页面、API、权限和 Service | 一段固定答案 | 影响分析任务上下文的输入清单 |
|
|
| 状态写入前要检查必需字段 | 一次性代码片段 | 状态变更检查单与反例 |
|
|
| 需要读源码、判断边界、列验证项 | 超长 Prompt | 多步状态变更审查 Skill |
|
|
| 数据库 NOT NULL 在此场景不合适 | “永远不要改数据库” | 条件化反例与取舍说明 |
|
|
|
|
</div>
|
|
|
|
<!--
|
|
逐字稿：同一个案例里会同时产生多种资产，但它们保存的是不同层次的信息。前端必填不能代替后端保护，可以沉淀成状态变更规则；页面、接口、权限和 Service 都要阅读，可以沉淀成任务上下文要求。字段名和异常文案仍然属于当前项目事实，不能直接推广。
|
|
|
|
案例事实不能原样搬到所有项目。可沉淀的是可重复的判断方法，例如“状态写入前检查必需信息”；字段名、异常文案、权限码和表结构仍需在新项目中重新取证。
|
|
-->
|
|
|
|
---
|
|
|
|
# 资产候选必须有证据来源
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 证据来源 | 可以升级的资产 | 还需要补什么 |
|
|
|---|---|---|
|
|
| 明确的项目规范、配置或接口契约 | Rule | 适用范围和验收方式 |
|
|
| 多次出现的同类提问与交付结构 | Prompt / Template | 必填输入与输出 Schema |
|
|
| 已发生的漏检、误用或缺陷 | Checklist / Example | 反例、触发条件和修复依据 |
|
|
| 可重复的多步分析与验证路径 | Skill | 各步骤输入、交接和停止条件 |
|
|
| 未经核对的模型建议或单次对话 | 暂不沉淀 | 先补项目事实或验证记录 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-6 p-3 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">
|
|
资产不是知识收藏；没有来源证据的内容只能是候选建议。
|
|
</div>
|
|
|
|
<!--
|
|
逐字稿：资产不是凭感觉升级的。项目规范和接口契约可以支撑 Rule，反复出现的任务结构可以支撑任务上下文契约，真实漏检和误用才能支撑检查单与反例。只有单次对话或模型建议时，最正确的动作是先保留为候选，不要急着写进团队资产。
|
|
|
|
这一页讲资产升级门槛。真正可用的资产应能回答：为什么形成、适用于哪里、遇到什么输入会失效。
|
|
-->
|
|
|
|
---
|
|
|
|
# 不值得沉淀的内容
|
|
|
|
<div class="grid grid-cols-2 gap-4 mt-8 text-sm">
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">
|
|
<div class="font-bold">单次对话结论</div>
|
|
<div class="mt-2 text-xs op-70">没有输入、证据和适用范围，下一次无法复核。</div>
|
|
</div>
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">
|
|
<div class="font-bold">项目特有字段或权限码</div>
|
|
<div class="mt-2 text-xs op-70">换项目后很可能失效，必须留在运行时输入中。</div>
|
|
</div>
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">
|
|
<div class="font-bold">没有验证过的模型建议</div>
|
|
<div class="mt-2 text-xs op-70">只能作为候选方案，不能升级为规则。</div>
|
|
</div>
|
|
<div class="p-4 rounded-xl bg-red-500/10 border border-red-500/30">
|
|
<div class="font-bold">一次性检查列表</div>
|
|
<div class="mt-2 text-xs op-70">重复价值不足时，保留在任务记录即可。</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!--
|
|
逐字稿：不沉淀同样是一项工程能力。一次性的聊天结论、项目私有字段、没有验证的模型建议和没有重复价值的清单，都不应该进入共享资产库。资产库保存的是下一次任务仍然可以复核的判断，而不是所有曾经出现过的内容。
|
|
|
|
资产化的关键能力也包括“不沉淀”。没有重复价值、缺少证据、脱离项目仍无意义的内容，继续保留在当前任务记录即可。
|
|
-->
|