86 lines
3.6 KiB
Markdown
86 lines
3.6 KiB
Markdown
|
# 开发与审计标准文档
|
|||
|
|
|
|||
|
|
> 本目录存放所有可复用的开发规范与审计标准，可直接发给 AI 使用。
|
|||
|
|
> **切换 AI 时**：先读 [`docs/project/standards-transfer-package.md`](../docs/project/standards-transfer-package.md)（全量转接 + 严谨性契约）。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 项目功能与接续（非本目录，但 AI 必读）
|
|||
|
|
|
|||
|
|
| 文档 | 路径 | 用途 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| **标准转接包** | [`docs/project/standards-transfer-package.md`](../docs/project/standards-transfer-package.md) | **全量标准索引**；逐行审查与开发同等强制 |
|
|||
|
|
| **AI 接续 SSOT** | [`docs/project/AI-HANDOFF-2026-05-23.md`](../docs/project/AI-HANDOFF-2026-05-23.md) | 待办、验证、端口模型、接续提示词 |
|
|||
|
|
| **全站功能清单** | [`docs/project/nexus-full-site-features.md`](../docs/project/nexus-full-site-features.md) | 18 页 + API 能力 Markdown 版 |
|
|||
|
|
| **开发验收标准** | [`docs/project/development-acceptance-standard.md`](../docs/project/development-acceptance-standard.md) | L0～L5 验收层级、命令、上线闸门 |
|
|||
|
|
| **功能说明书 HTML** | [`docs/Nexus-功能说明书.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.md`（Nexus 批次 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 1–4 审计实践提炼 |
|
|||
|
|
| 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 提炼的精简版 |
|