Harness setup

Skill lane2077/claude-code-harness-zh/skills/harness-setup

Harness v3 统一初始化技能。负责项目初始化、工具设置、2-agent 配置、记忆设置和公开技能 mirror 同步。用户提到以下内容时使用：setup、初始化、新项目、CI 设置、codex CLI 设置、harness-mem、agent 设置、symlink、mirror、harness-setup。不要用于实现、代码评审、发布或规划。From its SKILL.md

Install

npx -y skills add lane2077/claude-code-harness-zh --skill harness-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

6.4 KB, as published. Nobody here has run it

Harness Setup (v3)

Harness v3 的统一初始化技能。整合了以下旧技能：

setup — 统一初始化入口
harness-init — 项目初始化
harness-update — Harness 升级
maintenance — 文件整理与清理

Quick Reference

子命令	动作
`harness-setup init`	初始化新项目（CLAUDE.md + Plans.md + hooks）
`harness-setup ci`	配置 CI/CD 流水线
`harness-setup codex`	安装与设置 Codex CLI
`harness-setup harness-mem`	集成 harness-mem 并配置记忆
`harness-setup mirrors`	更新 `skills-v3/` → 公开 mirror bundle
`harness-setup agents`	配置 `agents-v3/` agents
`harness-setup localize`	对 CLAUDE.md 规则做本地化

子命令详情

init — 项目初始化

把 Harness v3 接入一个新项目。

生成文件：

project/
├── CLAUDE.md            # 项目配置
├── Plans.md             # 任务管理（空模板）
├── .claude/
│   ├── settings.json    # Claude Code 配置
│   └── hooks.json       # hook 配置（v3 shim）
└── hooks/
    ├── pre-tool.sh      # 轻量 shim（→ core/src/index.ts）
    └── post-tool.sh     # 轻量 shim（→ core/src/index.ts）

流程：

检测项目类型（Node.js / Python / Go / Rust / 其他）
生成最小可用的 CLAUDE.md
生成 Plans.md 模板
放置 hooks.json

ci — CI/CD 配置

配置 GitHub Actions 工作流。

# `.github/workflows/ci.yml` 生成示例
name: CI
on:
  push:
    branches: [main]
  pull_request:
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

codex — Codex CLI 配置

# 检查是否已安装
which codex || npm install -g @openai/codex

# 检查 timeout 命令（macOS）
TIMEOUT=$(command -v timeout || command -v gtimeout || echo "")
# macOS 下可用：`brew install coreutils`

使用方式（通过官方插件）：

bash scripts/codex-companion.sh task --write "任务内容"
# 或通过 stdin 输入
cat /tmp/prompt.md | bash scripts/codex-companion.sh task --write

harness-mem — 记忆配置

配置 Unified Harness Memory。

# 创建记忆目录
mkdir -p .claude/agent-memory/claude-code-harness-worker
mkdir -p .claude/agent-memory/claude-code-harness-reviewer

# 写入 MEMORY.md 模板
cat > .claude/agent-memory/claude-code-harness-worker/MEMORY.md << 'EOF'
# Worker Agent Memory

## Project Context
[项目概要]

## Patterns
[已学习的模式]
EOF

mirrors — 同步公开 skill bundle

在 Windows 的 core.symlinks=false 环境下，仓库里的 symlink 可能退化成普通文件，导致 harness-* skill 不出现在命令列表中。公开 bundle 会按真实目录 mirror 的形式同步。

./scripts/sync-v3-skill-mirrors.sh
./scripts/sync-v3-skill-mirrors.sh --check

更新目标：

skills/
codex/.codex/skills/
opencode/skills/

agents — agent 配置

配置 agents-v3/ 的 3-agent 结构。

agents-v3/
├── worker.md      # 实现负责人（task-worker + codex-implementer + error-recovery）
├── reviewer.md    # 评审负责人（code-reviewer + plan-critic）
└── scaffolder.md  # 脚手架负责人（project-analyzer + scaffolder）

localize — 本地化规则

让 .claude/rules/ 中的规则适配当前项目。

# 查看规则列表
ls .claude/rules/

# 追加项目专属规则
cat >> .claude/rules/project-rules.md << 'EOF'
# Project-Specific Rules
[项目专属规则]
EOF

安装插件（v2.1.71+ Marketplace）

从 v2.1.71 开始，Marketplace 的稳定性有了明显提升。

更新

claude plugin update owner/repo

从 v2.1.71 开始，更新时的 merge conflict 已修复，因此升级流程更稳定。

其他改进点

MCP server 去重：自动防止同一 MCP server 被重复注册
/plugin uninstall 改为使用 settings.local.json：更准确地反映用户本地设置

Maintenance —— 文件整理

定期维护任务：

任务	命令
删除旧日志	`find .claude/logs -mtime +30 -delete`
压缩 Plans.md	将已完成任务移到归档区
删除旧 trace	`tail -1000 .claude/state/agent-trace.jsonl > /tmp/trace && mv /tmp/trace .claude/state/agent-trace.jsonl`