用途:在 /aep-wrap 或用户测试之后闭合反馈回路,把真实观察转化为对产品上下文的可执行修改(故事图、架构或机会假设)。工作流位置为 /aep-envision → /aep-map → /aep-scaffold →[ /aep-design → /aep-launch → /aep-build → /aep-wrap ]→ /aep-reflect。
主要能力:读取产品定义与运行状态后,收集用户测试、错误日志、成本数据、产品直觉、dogfood 报告、lessons-learned 与层蒸馏等来源,归一化为观察记录;再把每条反馈归入五类之一并由用户确认或覆盖——bug(写入高优先级待办故事)、refinement(下一层新增或提前故事,含 calibration 子类型,按维度轻重路由到 /aep-calibrate)、discovery(回 /aep-envision 或 /aep-map 更新假设/架构)、opportunity shift(回 /aep-envision 第 0 阶段)、process(记录到 lessons-learned/process/ 并写 process_learnings,技能修订仅提案、由人应用)。随后重新切分地图的层分配,评估 outcome_contract(通过则推进,否则建议重切),做成本复盘,最后更新 product-context.yaml 或 product/index.yaml 并提交。
使用方式:在已完成层或用户测试后进行;输入为发布后的观察。验证 YAML 用 npx js-yaml product-context.yaml > /dev/null && echo "YAML OK";提交用 git pull --ff-only origin "$BASE"、git add product-context.yaml product/、git commit -m "chore: reflect — classify feedback and update product context"、git push origin "$BASE"。
适用场景:已有产品定义的迭代循环中收口反馈、调整层排序、评估结果契约与成本。限制:若 product/index.yaml 与 product-context.yaml 都不存在则无内容可反思,需先运行 /aep-envision 与 /aep-map;自动遥测摄取与 outcome 自动评估为可选配置,默认保留人工暂停;技能文件不会被自动修改;资料未提供收费或价格信息。