by-tech-plan

使用本 skill 辅助研发同学产出可评审、可落地、可上线的技术方案文档。重点不是把模板填满，而是先识别需求复杂度，暴露隐藏假设、澄清关键取舍，并留下能让研发、测试、发布和运维团队共同执行的方案。

最终文档必须先按 方案类型识别 选择输出结构。风险判断必须完成，但只有命中的风险维度才需要在正文展开；未命中的维度可以省略，或用一句话说明“不涉及，原因是...”。L2/L3 使用完整模板，L0/L1 使用轻量模板。

启动前置动作

开始拷问或起草前，先明确用户本次真正要完成的事情。

• 先用一句话复述你理解的需求目标，例如：“我理解本次是要为{需求/项目}产出一份可评审的技术方案，重点解决{核心问题}。”
• 如果用户没有提供材料，主动要求补充可用输入：PRD/需求文档、飞书文档、接口文档、代码仓库地址、目标分支、相关模块、历史方案或线上问题链接。
• 如果用户已经提供部分材料，先确认这些材料分别承担什么角色：PRD、技术背景、现有实现、接口约束、测试依据或上线约束。
• 如果代码仓库地址或文档地址暂时没有，也不要阻塞。说明你会基于当前上下文先推进，并把缺失材料记录到 问题记录。
• 明确交付物形态：只要 Markdown 草稿、要更新飞书文档、要生成可复制到模板的正文，还是要继续陪用户逐轮完善。

方案前置校准

进入拷问或起草前，先做一次简短校准，避免静默选择错误方向。