dsh-project-std

Readme

# AI 辅助大型项目开发规范及工作流

本仓库用于共同研究一套从项目启动、开发、交付到长期维护都可执行的 AI 辅助开发方法。

**适用范围约束（2026-09-02 确立）**：本规范的受支持宿主是 DeepSeek Harness（D-135，2026-10-04 起不再支持 Claude Code）。正文的写法仍按「换一种工具要不要改」判，所以规范正文只写**语义不变量**，不写任何具体工具的入口文件名、目录结构、配置格式或脚本。判定与检验机制见[跨工具通用性](docs/09-跨工具通用性.md)（D-020，已接受）：**一条要求说不出两种互不相同机制类型的落地方式，就不得进入正文（可在同一宿主内；跨工具一项因只有一个受支持宿主而记未定）。** 载体上的实现只作为[附录·载体实例](docs/附录-载体实例/README.md)与[模板](templates/README.md)存在，效力为零。

当前只构建理论、候选协议与 Markdown 模板，不编写业务代码；候选规则已可装成真实 Gate——`std-check`（TypeScript，随 DSH 插件 `dsh-project-std` 分发）可作提交门；执行层是该插件的守卫（`tools/std/README.md`「DSH 接法」；在隔离 profile 里从 git 地址实机装入并调用过，**模型在完整会话回合里实际加载技能的部分未验证**）。已有三个采用项目仍是内嵌 `.std/` 的旧接法，迁移方案由 `std-check migrate` 只读产出，本仓不替它们执行。**语料版本号只有一处**，在[项目状态](PROJECT_STATUS.md)的 `corpus_version`——本文与各章都不再各自声明版本。

> 决策效力：**当前哪些规则可阻断或授权，只查[生效登记表](docs/决策日志.md#effective-register)。** 本文不复制那张表的内容——**条数也不抄**，抄一次就多一处会过期的副本（08 §7）。2026-09-03 起[正文 117 条原则整套进入`试行`](docs/决策日志.md#effective-register)（D-057，2026-09-23 续期一期，到期日见登记表该行）：**正文文本自此有阻断与授权效力**，此前十四轮它们全无执行点。

## 核心判断

大型项目后期变慢，通常不是代码生成速度不足，而是交付链逐渐失真：事实来源混乱、上下文取并集、状态无法恢复、规则只存在于自然语言、完成声明没有绑定版本和环境的证据。

架构由多个独立来源归纳而来（来源基数与统计见[架构确定](docs/架构确定.md)）：**四个平面加一条交付线**。知识平面是资产、执行平面是工具、控制平面是纪律、责任平面是人；换 AI 编程工具换的只是执行平面。按部件的失败诊断表见[00 总览](docs/00-总览.md)。

## L0：会话入口

- [上下文清单](CONTEXT_MANIFEST.md)：唯一 Default Context Contract；
- [项目状态](PROJECT_STATUS.md)：本研究项目的里程碑摘要；
- 活动工作项：当前为 `N/A`，仍处于理论审议阶段。

只按上下文清单中的精确路径与片段读取；链接本身不触发递归加载。

## L1：正文（按四平面 14 部件组织）

- **[00 总览](docs/00-总览.md)**——先读这个：四平面、交付线、六条不变量、按部件的失败诊断表、L0–L3 成长路径、阅读地图
- [架构确定](docs/架构确定.md)——架构从哪些来源、怎么归纳出来的；六条不变量全文在 §5.3（全仓唯一一处），边缘部件裁决在 §6（D-047，已关闭）
- [架构图](docs/架构图/README.md)——可交互 HTML 与预览图（全部部件、五个引导视图 = 四个闭环 + 责任平面）

知识平面：[10 意图与验收](docs/10-意图与验收.md) · [11 项目知识](docs/11-项目知识.md) · [12 记忆与知识治理](docs/12-记忆与知识治理.md)

执行平面：[20 状态工件](docs/20-状态工件.md) · [21 调度与拆分](docs/21-调度与拆分.md) · [22 上下文装配](docs/22-上下文装配.md) · [23 方法库](docs/23-方法库.md) · [24 工具与执行环境](docs/24-工具与执行环境.md) · [25 执行者与模型](docs/25-执行者与模型.md)

控制平面：[30 验证与测试](docs/30-验证与测试.md) · [31 守卫与权限边界](docs/31-守卫与权限边界.md) · [32 证据与追踪](docs/32-证据与追踪.md) · [33 评估与演进](docs/33-评估与演进.md)

责任平面：[40 人的检查点与授权](docs/40-人的检查点与授权.md)

**每章四节**：最小职责与接口（含未决）／原则／L0–L3／追溯指针。"这一章为什么存在"、源章节映射、每条原则的证据强度不在正文，在[追溯账本](docs/追溯账本.md)（效力为零，默认不加载）。

元治理与索引：[08 规范效力元治理](docs/08-规范效力元治理.md) · [09 跨工具通用性](docs/09-跨工具通用性.md) · [术语表](docs/术语表.md) · [决策日志与生效登记表](docs/决策日志.md) · [决策索引](docs/决策日志.md#decision-index) · [追溯账本](docs/追溯账本.md)（无效力）· [附录·载体实例](docs/附录-载体实例/README.md)（无效力）· [历史版本](https://github.com/Alan-IFT/dsh-project-std/blob/archive-pre-ts-refactor/docs/%E5%BD%92%E6%A1%A3/%E5%8E%86%E5%8F%B2/README.md)

## 落地

- **[项目管理标准与示例项目](标准/README.md)**——管理、架构描述、Agent 上下文与运行维护的候选实现，附逐篇资料记录、采用检查和示例项目工件；效力为零；交付形态见 [D-108](docs/决策日志.md#decision-index)。
- **[文件树与落地路径](templates/文件树与落地路径.md)**——这套理论在一个真实工程项目里长什么样：L0～L3 四档各需要哪几个文件、哪些默认加载哪些按需、六条实测错法。**部件数不等于文件数**，L0 落地几个文件见其 [§1](templates/文件树与落地路径.md#not-14-files)。
- [模板目录](templates/README.md)：单个模板的字段集合。

模板用于把候选协议具体化，当前同样不代表规则已接受。

## 下一轮共同决策

**本节不复制议程。** 当前队列、优先级与每项的前提变化只有一处，在[决策索引](docs/决策日志.md#decision-index)；下一步的排序在[项目状态](PROJECT_STATUS.md#下一步)。

一句话现状：架构问题已全部关闭（D-043、D-047），加载控制已由上下文合同接管（D-015），正文已整套`试行`（D-057）。**目前最影响长期形态的不再是某条待裁项，而是一个期限**——D-057 的`试行`已续期一期（到期日见[生效登记表](docs/决策日志.md#effective-register) D-057 行），再续须三项检验有真实项目数据，而它最关键的检验（有没有原则真的拦住过东西）**在本仓库内答不完整，只能在一个真实产品项目上答**（见[项目状态](PROJECT_STATUS.md#下一步)）。