用途：DX Harness 用于审计、搭建并维护仓库的“开发者体验脚手架”（harness），即让开发循环变快的一键式元工具：一条命令完成初始化、重置、填充种子数据，以及可发现的约定和面向智能体的入口。它针对开发者体验的日常损耗——脚手架腐烂、手工步骤回流、约定漂移——进行系统性检测并提供规范修复。
适用时机：用户描述重复的手工琐事、提到上手缓慢或询问如何跑起来、新仓库需要从一开始就有脚手架、用户明确要求审计 DX 或测量 TTFC（首次提交时间）、要求补上缺失的 bootstrap/reset/seed 脚本或 AGENTS.md、或进行周期性维护（如发布后、新工程师入职后）。
主要能力与流程：DISCOVER（scripts/discover.sh → repo-fingerprint）、AUDIT（scripts/audit.sh → dx-audit.json）、PRIORITIZE（scripts/prioritize.sh → 排序结果）、SCAFFOLD（scripts/scaffold-*.sh → scratch 目录）、CONFIRM（向用户展示 diff，由用户选择应用哪些）、VERIFY（scripts/verify.sh → 断言与计时）、TRACK（scripts/track-attrition.sh → 审计日志）。所有脚手架编辑先落到 scratch 目录（${TMPDIR}/dx-harness-<timestamp>/），用户审阅 diff 后自行拷回仓库，不会直接写入工作树。
使用方式：需 bash、git、node、jq。运行时自动检测工具链（npm/pnpm/yarn/bun、cargo、go modules、Python uv/poetry/pip、just、make、docker compose、postgres），并据此适配，不强制迁移。首次调用会检查 config.json 并通过 AskUserQuestion 询问缺失的必填字段。常用命令：bash scripts/discover.sh > /tmp/fingerprint.json；bash scripts/audit.sh /tmp/fingerprint.json > /tmp/audit.json；bash scripts/prioritize.sh /tmp/audit.json；bash scripts/verify.sh；bash scripts/track-attrition.sh /tmp/audit.json。执行工作流前应阅读 references/workflow.md。
关键默认值：ttfc_target_seconds 为 60；apply_mode 为 scratch；audit_log_path 为 ${CLAUDE_PLUGIN_DATA}/dx-harness/audits.log。
风险与限制：风险级别为“写”，会写文件但不删除用户数据、不强推、不执行破坏性操作；默认先落到 scratch，由用户逐项批准。验证在单独的 git worktree 中运行，以免计时影响工作树。其他坑点见 gotchas.md。