1 . 安装 Claude
1.1 Homebrew 安装
export HOMEBREW_NO_AUTO_UPDATE=1
brew install --cask claude-code1.2 启动
在终端输入:
claude
2. 安装 harness-cli
2.1 一键安装(官方脚本,自动匹配 Mac 架构)
终端执行,默认安装到:~/.local/bin/harness-cli
curl -fsSL https://raw.githubusercontent.co/harness-cli/master/install.sh | bash若提示目录不在 PATH 中,把下面一行写入 ~/.zshrc(bash 用户用 ~/.bash_profile),保存后执行:
source ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"2.2 离线安装
2.2.1 安装 RUST 环境
RUSTUP_DIST_SERVER=https://rsproxy.cn RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup curl -sSf https://sh.rustup.rs | sh2.2.2 设置环境变量
source "$HOME/.cargo/env"2.2.3 验证版本
rustc --version
cargo --version2.2.4 编译安装
cargo build --release2.2.5 验证版本
harness-cli --version3. harness 初始化
3.1 输入命令
harness-cli init3.2 输出如下,需要手动输入 name

3.3 输入 name 回车后,会弹出下图来选择 agent 工具

3.4 选完 agent 工具后,会生成 .harness-cli、.cursor、.claude 三个目录

3.5 输入命令 harness-cli scan
下图所示(生成了 /hc 的命令,hc 是 harness-cli 的缩写)
1) harness scan-kb
作用:生成产品需求 PRD
自动读你的代码、业务逻辑 自动生成:产品功能说明、模块介绍、业务流程、接口清单
输出目录:
kb/prd/2) harness scan-kb-tech
作用:生成技术架构文档
自动分析:项目结构、技术栈、数据库设计、服务依赖、部署架构
输出目录:
kb/tech/4. Claude
4.1 在终端输入 claude

初始化 claude:
/init
4.2 根据提示命令进行知识库补全
/hc:scan-kb输出如下图,开始扫描原型图,生成需求 prd:

期间 claude 会请求操作,可以按回车赋予操作权限:

赋予权限后开始生成知识库
上图 harness 梳理完项目后,会根据项目给出选项,这里发现还没有 spec 编码规范,找一个模版项目,让 harness 学习规范,日志规范,目录规范,代码规范。
如果是微服务架构,需要跨层思维指南,输入以下指令:
填充 guides/ 目录
4.3 补全 tasks 文件
在 claude 终端输入,在 scripts 生成注册任务和读取上下文 py 文件。输出如下图,看到两个 py 文件已经生成:

4.4 开始项目开发,输入 hc/start

4.5 输入需求:/hc:brainstorm 编写一个 md 格式的需求文档

4.6 可以在 .harness-cli/tasks 目录下找到这次任务

4.7 任务结束后可以在目录找到生成的 md 需求文件
4.8 记住会话
输入 /hc:record-session 会生成该次对话的 md 文件,可以让 harness 重新开始任务后读取之前的会话,继续任务开发。
— End —
夜雨聆风