dsh-parallel-dev

使用

1. 开工前

pdev_preflight(project_root = "/path/to/project")

它会检查：团队工具是否真的存在、项目根是否被另一个编排会话占用、git 是否可用、已有验收记录覆盖情况。 返回的 blockers 不为空时不要降级硬做 —— 先告诉用户。

2. 团队开发 + 独立验收

1. Lead 用 team_task_create 建任务，写清 blocked_by 和 write_scopes；第一层尽量做宽。
2. 实施任务用 spawn_teammate；每个实施任务一个独立 worktree + 分支。
3. 实施方完成后，Lead 派一次性验收代理（subagent）独立核对。
4. 验收代理调用 pdev_verify_record 登记记录（判据 + 证据 + commit sha）。
5. 实施方或 Lead 调 team_task_update(action = "complete")；门禁命中记录才放行。

没有验收记录的 complete 会被拒绝，并返回正确做法与所需参数。

3. 用户豁免

用户本人明确表示某任务不需要验收时：

pdev_waive(task_id = "task-3", user_quote = "task-3 不用验收", reason = "文档改动")

插件会去本会话的用户消息里核对这句原话，并要求包含明确的豁免意思。编造的引用会被拒绝。 豁免会留痕，最终验收报告应列出所有豁免项。

4. 看板

• 浏览器打开 /pdev/board（拼在 DSH Web UI 地址后面）。
• 或在 DSH 侧栏打开「并行开发」面板：检测到未完成任务时会自动打开（可在设置页关闭）。
• 看板数据接口：/pdev/board/data，支持 ?session= 与 ?demo=1。

5. 设置页

设置 → 并行开发配置： 查看插件版本、加载状态、5 个服务是否可用、安装目录 / profile / 配置文件 / 数据目录、插件提供的能力、最近插件事件； 配置 8 项行为并保存（写入当前 profile 的 cordis.patch.yml）。

配置

配置全局一份，存在当前 profile 的 cordis.patch.yml，由设置页写入；默认值全部保持最严格行为。

分组	配置	默认	作用
功能	injectPolicy	开	是否把编排纪律注入系统提示
功能	autoOpen	开	检测到未完成任务时自动打开侧栏看板
时间线	timelineEnabled	开	记录任务状态变更到 .pdev/timeline.jsonl
时间线	timelineMaxEntries	60	内存中每个任务保留条数（10–500）
门禁	gateMode	enforce	enforce 拒绝；advise 只记录、不拒绝
门禁	requireEvidence	开	验收记录必须至少一条证据
门禁	requireCommitMatch	开	完成时 HEAD 必须等于验收记录的 sha
门禁	blockSelfCertification	开	禁止任务所有者给自己登记验收

放宽 gateMode 或任一严格项会让「完成」的可信度下降；设置页会二次确认并显示警告。修改只在保存后生效，Host 读侧最多 1 秒缓存。