name: ae:save-experience description: 统一经验沉淀入口:先保存 solution,再按需提炼 rules argument-hint: "[经验摘要|保存目标]"
AE 经验沉淀
本技能是推荐的统一经验保存入口,用于把当前会话中的可复用经验先沉淀为 solution,再按需提炼为长期 rules。
即使只保存长期项目规范,也使用本技能的 rules 分支,不再使用单独的 rules 保存入口。
工作流
- 先读取
references/save-solution.md,识别方案型经验并完成 solution 分支。 - 再读取
references/save-rules.md,识别规范型经验并完成 rules 分支。 - 最终汇总本次写入、取消项、脱敏结果和后续引用方式。
分类规则
- solution:审查发现、失败门禁、资产漂移修复、竞品研究、调试复盘、已验证方案和带权衡的案例。
- rules:未来必须长期遵守的项目规范、授权边界、架构约束、测试要求和跨会话稳定约定。
- 如果同一经验同时包含方案和规范,先保存 solution 作为证据,再只把真正长期稳定的约束提炼为 rules。
确认与取消
- solution 写入前必须展示目标路径、标题、语境标签、证据摘要和脱敏结果;用户未确认时不得写入文件。
- rules 写入前必须展示目标路径、规则标题、适用语境、已有规则去重结果、冲突检查、证据摘要和脱敏结果;用户未确认时不得写入文件。
- 如果用户取消 solution 写入但仍要求保存 rules,明确记录“无 solution 写入”,随后继续 rules 确认流程。
- 如果用户取消全部写入,只输出候选经验摘要和取消状态,不创建文件。
安全边界
- solution 和 rules 写入前都必须执行敏感信息门禁。
- 禁止保存 token、私钥、密码、完整环境变量、含密 URL、原始敏感日志、PII、客户数据、租户标识、内部凭证路径和不必要的绝对本机路径。
- 证据优先保存摘要、相对路径、失败主题、复现线索和已验证命令,不保存原始敏感输出。
- AE 插件源码维护专用经验必须标明语境;不得把仅适用于 AE 插件源码仓库的 rules 写入普通下游项目自动注入的
.opencode/rules/。
低成本引用
完成后提示后续计划、审查或研究流程可先检查 ae/solutions/ 和 .opencode/rules/,但首版不要求自动相似度检索或远程协作写操作。