Files
Nexus/standards/README.md
2026-07-08 22:31:31 +08:00

3.6 KiB
Raw Permalink Blame History

开发与审计标准文档

本目录存放所有可复用的开发规范与审计标准,可直接发给 AI 使用。
切换 AI 时:先读 docs/project/standards-transfer-package.md(全量转接 + 严谨性契约)。


项目功能与接续(非本目录,但 AI 必读)

文档 路径 用途
标准转接包 docs/project/standards-transfer-package.md 全量标准索引;逐行审查与开发同等强制
AI 接续 SSOT docs/project/AI-HANDOFF-2026-05-23.md 待办、验证、端口模型、接续提示词
全站功能清单 docs/project/nexus-full-site-features.md 18 页 + API 能力 Markdown 版
开发验收标准 docs/project/development-acceptance-standard.md L0L5 验收层级、命令、上线闸门
功能说明书 HTML docs/Nexus-功能说明书.html 面向人的全站说明(浏览器打开)

文档清单(权威正文在本目录)

1. 系统开发标准(完整版)

文件: system-development-standard.md
用途: 全栈系统开发规范,约束代码生成、Code Review、架构评审
涵盖: 实现铁律、架构分层、后端编码、前端安全、数据库规范、测试、迁移、文档交付

2. 逐行审计完整规范(完整版)

文件: line-walk-audit-standard-v2.md
用途: AI 执行全量逐行代码审计的完整操作手册
涵盖: 8 步走读流程、规则表(PY/FE/SH/SQL 共 27 条)、Closure 格式、批次规划、§十四 执行提示词

3. 审计核心原则(速查卡)

文件: audit-core-principles.md
用途: 精炼的审计底线,每次任务开始前给 AI 的系统提示词前缀
涵盖: 审计本质、实现原则、DoD 逐项勾选、严重度表、修复纪律、10 大高频漏报

docs/project/ 下同名文件为副本;冲突以本目录为准
Cursor 规则 audit-line-review.mdc 另引用 docs/project/line-walk-audit-standard.mdNexus 批次 SSOT)。


使用方式

给其他 AI 做代码审计(与团队同等严谨)

完整转接(推荐):
  → 粘贴 docs/project/standards-transfer-package.md §8 完整提示词
  → 或按该文档档 C 全文阅读三件套

最小化(仅原则,仍须满足 DoD):
  → 粘贴 audit-core-principles.md 全文
  → + line-walk-audit-standard-v2.md §十四.1 执行提示词
  → 附上要审计的代码

给其他 AI 做代码生成

→ 粘贴 system-development-standard.md 全文作为规范约束
→ + .cursor/rules/perfect-implementation.mdc + nexus-*.mdc

两者同时使用

系统提示词:
  [system-development-standard.md 全文]
  ---
  [audit-core-principles.md 全文]

任务:
  请按以上标准对 [目录/文件] 进行逐行走读审计,发现问题直接修复。

版本历史

版本 日期 变更
standards-transfer-package 2026-05-23 全量标准转接包,接续 AI 必读
system-development-standard v1.0 2026-05-23 从 Nexus mdc 规则 + Phase 14 审计实践提炼
line-walk-audit-standard v2.0 2026-05-23 整合 audit-line-review.mdc + PY-11~PY-20 新规则
audit-core-principles v1.0 2026-05-23 从 v2.0 提炼的精简版