用途:把被引用的规格或变更整理成准确的心智模型,供不参与代码工作的技术读者阅读。读者具备技术背景,能理解伪代码和精确表述,但没有看过代码、diff 或会话记录。
主要能力:用一个具体场景从头到尾走一遍(触发事件、当前行为、变更或未实现替代方案会做什么),而不是抽象描述属性;术语首次出现即定义;用小而具体的例子,但不以类比替代精确结论;解释控制流、顺序或时序时使用伪代码,写到决策层面(条件及其顺序),而非真实函数签名。
工作方式:读取完整被引用产物,必要时检查当前负责人;未指定产物时,解释会话当前变更(工作区或分支 diff),并区分现状与仅属提议的内容。通过用户或运维后果说明问题,以及当前设计为何产生该问题;把解决方案表述为一次简单的 before/after 数据流,按职责而非文件名介绍组件;穷尽列出 schema 与持久契约变更:新增、修改、删除、重置、刻意保持不变,涉及存储数据或读取方时包括游标或线格式切换;没有 schema 变更时明确说明。
输出结构:依次使用 Problem、Solution、Schema changes 三个标题,最后用一句短话说明变更后用户应注意到什么。
规则:先讲行为与边界,仅在澄清归属或契约时提实现名称;区分规范记录与派生索引、缓存、摘要和展示分组;直接指出破坏性重置、迁移要求、兼容行为、最终一致性和有意数据丢失;不因某项 schema 变更属于运维而非用户可见就省略。
限制:资料未提供具体安装命令、平台支持、收费方式或效果数据;该技能依赖被引用的规格或变更产物,缺少产物时只能基于当前会话变更进行说明。