文档园艺（Harness Gardening）

eval $(bash "$SKILL_ROOT/harness-engineering/scripts/harness-setup-git.sh")
# 输出 GITATTR_MODIFIED=true/false

eval $(bash "$SKILL_ROOT/harness-engineering/scripts/harness-diff-base.sh")
# 输出 REPORT_PATH 和 DIFF_BASE 两个环境变量

1. 获取变更文件列表（增量 diff）
   执行：CHANGED=$(bash "$SKILL_ROOT/harness-engineering/scripts/harness-changed-files.sh" "$DIFF_BASE" "$REPORT_PATH")
   - 若输出含 UPGRADE_TO_FULL → 自动升级为全量扫描（执行 mode=full 流程）
   - 若输出为空 → 输出"无新变更，无需检查"并退出

2. 根据变更文件推断受影响维度：
   - 新增/删除 `$SKILL_ROOT/` 下目录 → 维度 2（Skill 清单）+ 维度 7（工具依赖）
   - 修改 `$SKILL_ROOT/harness-engineering/references/tool-dependencies.md` → 维度 7（工具依赖）
   - 修改 `agents/*.md`（开发仓）或 `{SKILL_ROOT}/../agents/*.md`（接入仓） → 维度 7（工具依赖）
   - 修改 go.mod / package.json → 维度 4（技术规范同步）[仅 code-project / mixed]：检测新增技术栈，对比并同步预设
   - 新增/删除 `docs/standards/` 下文件 → 维度 4（技术规范同步）：对比并同步预设
   - 新增/移动/删除文件 → 维度 1（路径有效性）+ 维度 6（目录结构）+ 维度 8（Dev Map 与 IDE 集成一致性）
   - 修改 internal/ 或分层相关目录 → 维度 3（架构描述）
   - （已移除）修改 `../assets/workflow-template.md` → 维度 9 已 Skip，不再触发
   - 新增/删除 `.cursor/` / `.codebuddy/` / `.claude/` 目录 → 维度 8（Dev Map 与 IDE 集成一致性）
   - 新增/删除/修改 `**/rules/graphify.mdc` / `**/rules/graphify.md` → 维度 8
   - 新增/删除/修改 `docs/business-standards/` 下文件 → 维度 10（业务规范一致性）
   - 修改根 `AGENTS.md` / `docs/standards/` / 任意 `standards-*.mdc` / `standards-*.md` → 维度 11（Standards Rules 一致性）+ 维度 12（AGENTS 项目记忆 / 工作单元索引；根 AGENTS 变更时）
   - 新增/删除/修改任意非根 `**/AGENTS.md` → 维度 12（工作单元索引与误改局部检测）
   - 新增/删除 `.agents/`（或与 Rules 相关的 `.cursor` / `.codebuddy`）→ 维度 11
   - 若无维度被触发 → 输出"无需检查"并退出

3. 仅运行被触发的维度
   读取 references/detection-dimensions.md 获取各维度的检测规则

4. 汇总并处置
   a. 按 P0 / P1 / Skip 分类所有检测结果
   b. 若存在 P1：向用户逐条列出 P1 修复方案，等待确认
      - 用户确认：纳入本次执行
      - 用户拒绝/延迟：追加到 docs/harness/gardening-proposals.md 备用
   c. 执行全部 P0 修复 + 用户确认的 P1 修复
   d. 生成/更新 $REPORT_PATH（last-commit 字段先填占位值 "pending"）
      git add <所有修复文件> $REPORT_PATH [.gitattributes（若步骤 A 有修改）]
      git commit -m "docs(gardening): ..."（新建独立 commit，不 amend 已有提交）
   e. 写入 last-commit（仅 $DIFF_BASE 为空时执行，即 master/非 issue 分支）：
      1. git rev-parse HEAD → 获取步骤 d 产生的 commit SHA
      2. 更新 $REPORT_PATH 中 "> last-commit: " 行的值为该 SHA
      3. git add $REPORT_PATH && git commit --amend --no-edit
   f. Skip：记录到报告但不处理
   g. 若无 P1（仅 P0）：跳过步骤 b，直接执行 c → d → e

1. 读取目标项目的所有 Harness 文档
   - AGENTS.md
   - docs/harness/*.md
   - docs/standards/*.md
   - docs/glossary.md
   - docs/dev-map/*.md（若存在）
   - docs/workflow.md（若存在）

2. 依次运行十二个检测维度
   读取 references/detection-dimensions.md 获取详细规则

3. 汇总检测结果，按 P0/P1/Skip 分类

4. 处置
   a. 若存在 P1：向用户逐条列出 P1 修复方案，等待确认
      - 用户确认：纳入本次执行
      - 用户拒绝/延迟：写入 docs/harness/gardening-proposals.md 备用
   b. 执行全部 P0 修复 + 用户确认的 P1 修复
   c. 生成 $REPORT_PATH（last-commit 字段先填占位值 "pending"）
   d. git add <所有修复文件> $REPORT_PATH [.gitattributes（若步骤 A 有修改）]
      git commit -m "docs(gardening): ..."（新建独立 commit，包含修复 + 报告）
      然后写入 last-commit（仅 $DIFF_BASE 为空时执行）：
      1. git rev-parse HEAD → 获取步骤 d commit 的 SHA
      2. 更新 $REPORT_PATH 中 "> last-commit: " 行的值为该 SHA
      3. git add $REPORT_PATH && git commit --amend --no-edit
   e. Skip：记录到 $REPORT_PATH 但不处理
   f. 若无 P1（仅 P0）：跳过步骤 a，直接执行 b → c → d

5. 输出总结报告给用户（已修复项、延迟 P1 项、Skip 项）

1. 解析 target 参数，确定目标维度：
   - dim-N 格式（N=1~12）→ 直接取维度 N
   - 具名 target → 按以下映射转换：
     paths        → 维度 1（路径有效性）
     skills       → 维度 2（Skill 清单一致性）
     architecture → 维度 3（架构描述一致性）
     standards    → 维度 4（技术规范同步）
     glossary     → 维度 5（词汇表完整性）
     structure    → 维度 6（目录结构一致性）
     tooling      → 维度 7（工具依赖一致性）
     dev-map      → 维度 8（Dev Map 与 IDE 集成一致性）
     workflow     → 维度 9（工作流文档同步）
     business-standards → 维度 10（业务规范一致性）
     standards-rules → 维度 11（Standards Rules 一致性）
     agents-merge / agents-memory → 维度 12（AGENTS 项目记忆保留）
   - 无法识别 → 列出所有合法 target 值并退出

2. 仅读取该维度所需的 Harness 文档（按 references/detection-dimensions.md 中维度扫描范围定义），
   读取 references/detection-dimensions.md 获取该维度的检测规则

3. 执行目标维度检测

4. 汇总并处置（流程同全量模式步骤 4，新增 h：无偏差时不 commit）：
   a. 按 P0 / P1 / Skip 分类检测结果
   b. 若存在 P1：向用户逐条列出 P1 修复方案，等待确认
      - 用户确认：纳入本次执行
      - 用户拒绝/延迟：写入 docs/harness/gardening-proposals.md 备用
   c. 执行全部 P0 修复 + 用户确认的 P1 修复
   d. 生成/更新 $REPORT_PATH：
      - 在报告中注明本次为 targeted 扫描，记录 target 值与对应维度编号
      - last-commit 字段先填占位值 "pending"
      git add <所有修复文件> $REPORT_PATH [.gitattributes（若步骤 A 有修改）]
      git commit -m "docs(gardening): targeted <target> ..."（新建独立 commit）
   e. 写入 last-commit（仅 $DIFF_BASE 为空时执行）：
      1. git rev-parse HEAD → 获取步骤 d 产生的 commit SHA
      2. 更新 $REPORT_PATH 中 "> last-commit: " 行的值为该 SHA
      3. git add $REPORT_PATH && git commit --amend --no-edit
   f. Skip：记录到报告但不处理
   g. 若无 P1（仅 P0）：跳过步骤 b，直接执行 c → d → e
   h. 若无任何偏差：输出"目标组件 <target> 未检测到偏差"并退出（不 commit）

docs/harness/
├── gardening-report.md       # 非 workflow 场景报告（merge=ours 兜底，master 周期扫描用）
└── gardening-proposals.md    # 用户拒绝/延迟的 P1 方案（执行后由下次扫描清空）

workflows/issue-N/
└── gardening-report.md       # workflow 场景报告（随 PR diff 可见，路径隔离无冲突）