# dsh-continual-evolve — 项目规则 DeepSeek Harness 的持续自我进化插件：从会话轨迹中提炼**版本化、可审计、可回滚**的 harness 状态（prompt notes / memories / skills / subagent specs）。TypeScript npm 库，以 cordis 插件形态挂载（`cordis.patch.yml`）。 ## 协作模式（AI + 人） - 本仓库由 coding agent（DeepSeek Harness）+ 人协作开发；agent 先读本文件与本仓库技能再动手。 - 每次动手前说清变更范围；**非平凡变更必须同变更携带 Agent Note（ADR）**（见 `.agents/notes/README.md`）。改行为、架构、跨模块契约、状态/wire 格式、流程者皆属非平凡；纯机械、局部编辑豁免。 - 讨论与取舍落成 ADR，不散在会话里；ADR 强制 `## Alternatives considered`。 ## 流程卡（索引） 会话与开发流程按卡执行： - [session-modes](.agents/workflows/session-modes.md)——模式契约：讨论/调研/实现/发布的许可边界；**会话开场必须声明模式** - [session-open](.agents/workflows/session-open.md) / [session-close](.agents/workflows/session-close.md)——会话开、收尾检查单 - [feature-flow](.agents/workflows/feature-flow.md) / [release-flow](.agents/workflows/release-flow.md)——开发与发版主链路 ## 文档纪律 - **每个事实只有一个家**：rationale → Agent Notes；使用方法 → README/docs；规则 → 本文件 + 链接。 - durable 文档**写当前状态，不写变更历史**（"previously / now / no longer / renamed" 是 slop）。 - ADR 路径即元数据：`{lifecycle}/{class}/yyyy-mm-dd-.md`；`rejected` 仅当理由能防重蹈覆辙才保留；`archived` 永久冻结。 - 相对 Markdown 链接 + 机器可校验；禁裸文件名引用。 ## 编码约定（TypeScript） - **fail loud**：缺失引用、误配置绝不静默跳过；空 `catch` 必须命名它吞掉什么；`try` 只包一个语句。 - 公共 API 带 TSDoc 契约（`@param/@returns/@throws`）；跨界 ID 用 Branded 类型，禁裸 `string` 跨模块传递。 - 可调参数进 schemastery 配置模型，禁止硬编码；协议常量与安全不变量保持固定。 - 测试：vitest（`pnpm test`）；覆盖边界、错误路径、事件顺序、并发；**行为级变更必须配套回归测试**；mock 只用于昂贵/非确定性边界（LLM 调用、时钟）。 - 构建产物只进 `lib/`（tsc），源码只在 `src/`；不手改 `lib/`。 ## GitHub 调研纪律（强制） 调研 GitHub 项目一律 gh CLI；禁以 web 检索开局、禁全量克隆作首选。六步配方见 [.agents/workflows/github-research.md](.agents/workflows/github-research.md)。 ## 检索通道路由（强制） web 检索优先 anysearch 纵向面（zone/tag/params 富参数）；GitHub 归 gh；无纵向诉求的快查可用内置 web_search。路由表见 [.agents/workflows/search-routing.md](.agents/workflows/search-routing.md)。 ## Git 纪律 - 改写历史必须 `--force-with-lease=:`；**raw `--force` 永远禁止**；改写后重新审计评审状态。 - push 前最小证据：按 diff 面选最窄检查（先用 `scripts/change-scope.sh`）；hooks 只做快检查，CI 拥有穷尽矩阵（node 22/24）。 ## 质量门（当前可执行） ```sh pnpm typecheck && pnpm lint && pnpm test # TS 工程链（vitest + oxlint） pnpm check:docs # 文档门禁（tsx run-gates：adr/预算/链接/治理） scripts/change-scope.sh [ ] # 变更范围（评审/push 前置） ``` ## 字数预算 | 文件 | 上限 | |---|---| | 本文件（AGENTS.md） | ≤ 800 词 | | .agents/AGENTS.md | ≤ 300 词 | | .agents/notes/README.md | ≤ 800 词 | 超限：迁移到其他层（留一行链接）→ 精简 → 才允许提额度（PR 说明理由）。 ## 参考 - 协作体系与技能出处见 `.agents/AGENTS.md`；全部技能源自 `deepseek-ai/deepseek-harness`（MIT）。 - 插件设计背景见 `docs/design.md` 与 `docs/research/`。