用途:在代码编写前先通过架构提案对齐团队认知。资料认为修改文档比重构代码成本更低,适用于架构变动使原有假设失效、产品方向变化需要新基础、决策将影响多个波次/里程碑、外部依赖(Copilot CLI、SDK API)变化等场景。
主要能力:给出提案结构,文件放在 docs/proposals/ 下,必需章节有问题陈述(具体可测证据)、拟议架构(技术细节)、变更内容(对波次、里程碑、模块的影响)、保持不变的部分(避免回归)、需做的关键决策、风险与缓解、范围(v1 与延后项);可选章节有实施计划、成功标准、开放问题、附录(先例与备选方案)。另含语气上限规则:始终引用具体证据、用技术理由支撑建议、承认权衡、明确 API/库/文件路径;禁止炒作、含糊其辞、无依据断言和模糊时间线。还给出波次重构模式(承认转变、级联影响、保留非阻塞工作、更新依赖)与决策框定格式(推荐项、备选项、理由、需谁签字)及风险记录格式(风险、可能性、影响、缓解措施,均以低/中/高表示)。
使用方式:资料未提供安装命令或调用方式,仅给出写作与审阅时可参照的模式。示例文件引用包括 docs/proposals/squad-interactive-shell.md、.squad/decisions/inbox/copilot-directive-2026-02-21T202535Z.md、.squad/decisions.md、docs/architecture/module-map.md、docs/prd-23-release-readiness.md。
适用场景:涉及架构级决策、多波次规划、外部依赖变更时的提案撰写与评审。
限制:资料为方法说明,未提供实际工具安装或运行步骤;具体命令、价格、平台支持等信息暂未提供。