architectural-proposals

仓库创建 2026年4月15日最近提交 20 天前SkillHot 收录 20 天前

⬈ GitHub 仓库 ⬈ SKILL.md 原文件 ⬇ Raw 原始文件

▸ 精选理由

促成早期对齐，降低后期重构与返工成本。

这个 Skill 做什么

指导如何撰写全面的架构提案以在编码前达成一致。

教你怎么写能在动手编码前就把团队对齐的架构提案，把关键设计决策、影响范围和替代方案写清楚。适合在架构变动、产品方向调整或多里程碑受影响时使用，便于早期沟通和风险评估。特点是把改动成本前置为文档討論，能避免后期反复大幅重构。

▸ 展开 SKILL.md 英文原文

How to write comprehensive architectural proposals that drive alignment before code is written

办公文档架构提案设计文档决策记录通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/Codebrew-company/CodebrewRouter/master/.copilot/skills/architectural-proposals/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/Codebrew-company/CodebrewRouter/master/.copilot/skills/architectural-proposals/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

## Context

Proposals create alignment before code is written. Cheaper to change a doc than refactor code. Use this pattern when:
- Architecture shifts invalidate existing assumptions
- Product direction changes require new foundation
- Multiple waves/milestones will be affected by a decision
- External dependencies (Copilot CLI, SDK APIs) change

## Patterns

### Proposal Structure (docs/proposals/)

**Required sections:**
1. **Problem Statement** — Why current state is broken (specific, measurable evidence)
2. **Proposed Architecture** — Solution with technical specifics (not hand-waving)
3. **What Changes** — Impact on existing work (waves, milestones, modules)
4. **What Stays the Same**

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有