mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-20 23:54:26 +08:00
61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# Change Workflow
|
||
|
||
## 目标
|
||
|
||
给 AI 一个稳定的执行顺序，避免直接跳到编码而漏掉规格、文档和回归验证。
|
||
|
||
## 推荐流程
|
||
|
||
1. 读取 `AGENTS.md`
|
||
2. 读取 `docs/ai/DOC_SOURCES.md`，确认这次需求涉及哪些权威文档
|
||
3. 按需读取 `docs/ARCHITECTURE.md`、专题规范和相关目录内 README
|
||
4. 检查 `.trae/specs/` 是否已有对应 feature
|
||
5. 如果是新功能或行为变化，先补或更新 `spec.md / tasks.md / checklist.md`
|
||
6. 再改代码
|
||
7. 补测试或复用已有测试文件
|
||
8. 运行最小必要验证
|
||
9. 回写文档入口和迁移说明
|
||
|
||
## 什么时候必须先更新 `.trae/specs/`
|
||
|
||
- 用户可见行为变化
|
||
- 设置页或主界面结构变化
|
||
- 组件系统规则变化
|
||
- 插件宿主集成、共享契约、SDK 使用模式变化
|
||
|
||
## 什么时候可以直接改代码
|
||
|
||
- 纯文档修复
|
||
- 不改变行为的内部重构
|
||
- 小范围 bugfix 且现有 spec 已完整覆盖该功能意图
|
||
|
||
## 最小验证清单
|
||
|
||
默认优先：
|
||
|
||
```bash
|
||
dotnet build LanMountainDesktop.slnx -c Debug
|
||
dotnet test LanMountainDesktop.slnx -c Debug
|
||
```
|
||
|
||
按需增加：
|
||
|
||
- 运行桌面宿主验证 UI 或启动行为
|
||
- 检查插件打包或 market 调试路径
|
||
- 手工验证设置页、主题切换、组件布局等高风险交互
|
||
|
||
## 回写要求
|
||
|
||
出现以下变化时，AI 应同步回写文档：
|
||
|
||
- 命令变化：更新 `docs/DEVELOPMENT.md`
|
||
- 模块职责变化：更新 `docs/ARCHITECTURE.md`
|
||
- 产品定位或阶段变化：更新 `docs/PRODUCT.md`
|
||
- AI 入口或权威来源变化：更新 `AGENTS.md` 或 `docs/ai/DOC_SOURCES.md`
|
||
|
||
## 不要做的事
|
||
|
||
- 不要把根目录 `README.md` 写成 feature 详细设计文档
|
||
- 不要在多份文档里重复维护同一条事实
|
||
- 不要把 `LanAirApp` 的资料误写成本仓库权威来源
|