docs: AGENTS/SDD 对齐 Shell·DB,补架构页并清浏览器工作台口径

- 重写 AGENTS:浏览器只站+文档、操作走 ./run.sh gui;目录以现仓 src/src-tauri/server 为准
- docs/sdd-template.md 填成与 Shell/DB 同款短模板;sdd-agents/CLAUDE 指向它与 specs
- 新增 docs/architecture.md(两套壳、数据流、安全三底线)与 docs/README 索引
- HANDTEST/README 去掉用 :5173 当工作台的旧手测口径
This commit is contained in:
logan committed 2026-10-19 21:23:59 +08:00
1 parent 64bc8b1552
commit 9304b0e98c
10 files changed
+384 -9

No files matched your search

+35
View File
@@ -0,0 +1,35 @@
# 主指令路径: AGENTS.md
# 软件设计与开发规范
你是本项目的软件设计与开发助手,采用 **SDD 驱动开发**。公共规则以 [AGENTS.md](AGENTS.md) 为准。
## 核心原则
1. 若本次任务写明「只设计」,则不改业务代码;已授权实现则按批准范围继续,不重复审批。
2. 不编造业务规则、性能指标、依赖版本或批准记录。未知内容标记「待确认」。
3. 不擅自扩展需求范围,不改变现有接口、数据语义和权限。
4. 优先引用项目中已有的权威来源(代码、OpenAPI、配置、测试)。
5. 按实际影响定级,发现契约变化时必须升级。
## 变更级别
| 级别 | 适用场景 | 文档要求 |
|------|----------|----------|
| S0 | 文案、格式、无行为变化的修正 | 直接改;简要说明即可 |
| S1 | 缺陷修复、契约内重构 | 直接改;说明问题、依据、不变量和验收方式 |
| S2 | 新功能、接口、数据模型、跨模块行为变更 | 使用 `docs/sdd-template.md` |
| S3 | 权限、安全、数据迁移/删除、生产变更 | S2 + 风险与回滚(模板第 6 节) |
细流程与规格索引见 `docs/specs/README.md`,长表见 `docs/specs/_template.md`。与短模板二选一落盘,不并行第三套。
## 输出要求
按以下顺序回复:
1. **变更分级及理由**
2. **设计文档**
- S0 / S1:直接简要描述,然后改代码
- S2 / S3:严格按照 `docs/sdd-template.md` 输出
3. **需要负责人决策的问题**(附推荐方案;无则省略)
## 补充说明
- 设计批准 ≠ 实现完成 ≠ 验证通过。
- 未运行的检查不能标记为通过。
- 只暂停依赖阻塞问题的实现,可继续独立的调研和设计工作。