dsh-project-std

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

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

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

当前只构建理论、候选协议与 Markdown 模板，不编写业务代码；执行层提供标准技能与 std-check（TypeScript，随 DSH 插件 dsh-project-std 分发），检查器可接入项目提交门。插件另含默认关闭、显式项目路径 opt-in 的守卫职责收缩层与配置治理入口（std_config，不改变检查器语义），接入契约与限制只看 tools/std/README「DSH 接法」；这些已通过本地回归与真实 ASAR 隔离组合的接缝核验，并已在 2026-10-15 由用户经 Desktop 正常入口安装固定提交 a035（配置治理于 2026-10-16 装入 3ae6da0）。2026-10-17 宿主升级到 DSH 0.2.1-rc.2 后，旧安装因 engines.dsh 版本校验被整包跳过，技能与 std_config 当前不在真实会话中；源码已支持 0.2.1-rc.2，等待用户重装本轮提交，部署状态以项目状态为准。此前旧版的装入、技能加载与询问采纳证据保留在历史设计 §12.43，版本校验的经过见审计记录。三个采用项目的旧接法只作为历史线索，本仓本轮未重新核其现状；当前迁移指引已完成独立只读接手演练，迁移方案由 std-check migrate 只读产出，实际迁移由各项目自己的会话执行。语料版本号只有一处，在项目状态的 corpus_version——本文与各章都不再各自声明版本。

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

核心判断

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

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

L0：会话入口

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

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

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

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

知识平面：10 意图与验收 · 11 项目知识 · 12 记忆与知识治理

执行平面：20 状态工件 · 21 调度与拆分 · 22 上下文装配 · 23 方法库 · 24 工具与执行环境 · 25 执行者与模型

控制平面：30 验证与测试 · 31 守卫与权限边界 · 32 证据与追踪 · 33 评估与演进

责任平面：40 人的检查点与授权

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

元治理与索引：08 规范效力元治理 · 09 跨工具通用性 · 术语表 · 决策日志与生效登记表 · 决策索引 · 追溯账本（无效力）· 附录·载体实例（无效力）· 历史版本

落地

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

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

下一轮共同决策

本节不复制议程。 当前队列、优先级与每项的前提变化只有一处，在决策索引；下一步的排序在项目状态。

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