16 · 文件索引
文件索引
本手册涉及的所有路径，按所在层排列。
| 路径 | 层 | 作用 |
|---|---|---|
AGENTS.md / CLAUDE.md | 指令 | 根标准规则，字数上限 2,080；CLAUDE.md 指向它 |
packages/AGENTS.md | 指令 | 包的设计与测试规则 |
docs/AGENTS.md | 指令 | 文档分层、写作规则、字数预算、slop 清单 |
snapshots/AGENTS.md、scripts/AGENTS.md、.github/AGENTS.md | 指令 | 各子树的补充规则 |
.agents/skills/dsh-prose-standard/ | 指令 | 文字的必写内容与编辑判断 |
.agents/skills/dsh-trim-cot-leakage/ | 指令 | 推理泄漏的分类、例子和检索探针 |
.agents/skills/dsh-find-simplifications/ | 指令 | 有证据的删减 |
.agents/skills/dsh-code-review/ | 指令 | PR 评审 |
.agents/skills/cordis-styling-nitpicking/ | 指令 | 插件生命周期 P0 检查 |
.agents/skills/dsh-error-handling/ | 指令 | 失败分类、owner、报告 |
.agents/skills/dsh-pre-push-checks/ | 指令 | 推送前的最小证据选择 |
.agents/skills/dsh-ci-test-reliability/ | 指令 | 防 flaky 测试 |
.agents/skills/dsh-doc/ | 指令 | 文档创建与审计流程、模板 |
packages/preset/agent-preset/skills/agent-experience/ | 指令 | 面向运行时模型的工具与 skill 设计原则 |
docs/defensive-patterns/ | 规范 | 评审强制执行的规则，附正反例 |
docs/architecture.md、docs/glossary.md、docs/capability-seams.md | 规范 | 结构地图与术语 |
docs/testing.md | 规范 | 测试分层与策略 |
docs/cookbook/ | 规范 | 带验证步骤的操作手册 |
docs/subsystems/ | 规范 | 类型定义与语义 |
.agents/notes/ | 记忆 | 决策记录，按生命周期和类别分目录 |
docs/postmortem/ | 记忆 | 事故复盘 |
docs/upgrade-guide/ | 记忆 | 破坏性变更的升级指南 |
tsconfig.base.json | 门禁 | 严格模式 |
.oxlintrc.json、.oxlintrc.staged.json | 门禁 | lint 规则；staged 版用于提交前快速检查 |
.jscpd.json | 门禁 | 跨文件克隆检测 |
lefthook.yml | 门禁 | git hook：pre-commit 与 pre-push |
scripts/run-gates.ts | 门禁 | 门禁聚合与调度 |
scripts/verify-*.ts、scripts/gen-*.ts | 门禁 | 约 50 个专项检查与生成物新鲜度检查 |
scripts/doc-budgets.manifest.json | 门禁 | 文档字数上限 |
.editorconfig、.gitattributes | 门禁 | 统一 LF 与结尾换行 |
.github/workflows/ci.yml、ci-master.yml | 门禁 | PR 检查与 master 平台检查 |
packages/*/*/tests/ | 证据 | 单元测试，每文件 100% 覆盖 |
snapshots/ | 证据 | 无 key 录制会话回放 |
benchmarks/ | 证据 | 性能门禁 |
.github/pull_request_template.md | 证据 | 动机、改动、测试与 Proof |
.github/review-ownership/、.github/workflows/weighted-approval.yml | 证据 | 基于维护者权重、作者记录和 blame 所有权的审批评分 |
scripts/no-unknown-casts.baseline.json | 门禁 | as unknown 的存量清单，只减不增 |
.agents/skills/dsh-merging-stacked-prs/ | Git | 用 GitHub 原生 stack 落地依赖 PR |
docs/cookbook/responding-to-pr-review-on-a-stack.md | Git | 在 stack 上回应评审，修复放在引入层 |
.agents/notes/implemented/process/2026-08-02-native-github-stacks-and-optional-rebases.md | Git | merge-forward 与 rebase、lease 保护的决策 |
.agents/notes/implemented/process/2026-08-08-unified-github-label-taxonomy.md | Git | kind/*、area/* 标签体系 |
说明
本手册依据 deepseek-harness 仓库 master 分支及其 git 历史整理。各 verify-* 脚本的描述来自其文件头注释，未逐一阅读实现；git 统计基于最近 3,000 次非合并提交和 1,500 次 master 第一父提交；引用的英文原句均出自仓库文件或提交信息。