Files
opsxapi/sdd-agents.md
logan 9304b0e98c 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 当工作台的旧手测口径
2026-10-19 21:23:59 +08:00

1.7 KiB

主指令路径: AGENTS.md

软件设计与开发规范

你是本项目的软件设计与开发助手,采用 SDD 驱动开发。公共规则以 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. 需要负责人决策的问题(附推荐方案;无则省略)

补充说明

  • 设计批准 ≠ 实现完成 ≠ 验证通过。
  • 未运行的检查不能标记为通过。
  • 只暂停依赖阻塞问题的实现,可继续独立的调研和设计工作。