prod-handoff-create

name	prod-handoff-create
description	在生产环境中, 当用户已明确要求生成、创建、归档或交接生产问题 handoff, 且问题事实已和用户确认后使用。用于把生产问题整理为开发环境可接手的交接文档, 可在配置了 peer.devRoot 时写入开发环境 .temp/prod-handoff/, 但不得写入当前生产项目。

Prod Handoff Create

使用本技能把已确认的生产问题交接给开发环境。

Preconditions

• 只在生产环境中使用。
• 仅当用户明确要求生成、创建、归档或交接 handoff 时使用。
• 写入 handoff 前，必须先和用户确认问题事实、影响范围和证据；信息不足时先提出待确认问题，不写文件。

Handoff 内容

交接应包含：

• 标题
• 生产环境与时间
• 现象与影响范围
• 已观察到的证据，如日志摘要、错误信息、版本或配置状态
• 已确认事实
• 未确认假设
• 风险与紧急程度
• 建议开发环境下一步

不要包含密钥、token、隐私数据或完整敏感配置。

写入规则

• 默认不写当前生产项目下的任何文件。
• 读取 docs/agent/.agent-env.json；仅当其中配置了 peer.devRoot 时，允许写入 <devRoot>/.temp/prod-handoff/。
• 写入前解析目标路径，确认最终路径位于 <devRoot>/.temp/prod-handoff/ 内。
• 文件名使用时间戳和简短 slug，避免覆盖既有文件。
• 不写入 devRoot 的其他位置，不修改开发环境代码或 backlog。
• 未配置 peer.devRoot 时，只在对话中输出 handoff 内容，并提示用户提供开发环境路径或手动交接。