@hunterzheng/harness

个人开发工具，用于在中小型项目中沉淀项目结构、开发计划、测试证据、代码审查结果和知识资产。

开发

以下内容仅适用于本仓库开发者。

技术栈

• TypeScript 5.5+
• commander
• tsup
• vitest
• eslint
• @inquirer/prompts
• chalk

命令

npm install
npm run build
npm run test
npm run test:watch
npm run lint
npm run typecheck

源码结构

| 目录 | 职责 | | --- | --- | | src/bin/harness.ts | CLI 入口 | | src/cli/ | 命令注册、全局选项、交互式提示、输出格式化 | | src/core/ | 配置 schema、路径契约、状态管理、事务、安装和健康检查 | | src/capabilities/ | inspect、sync、develop、test、review、knowledge、safety 等能力实现 | | src/adapters/ | AI 工具投影源模板和渲染逻辑 | | src/commands/ | config、doctor、status 等顶层命令 | | test/ | 单元测试和契约测试 |

测试沙箱

涉及安装投影、模拟用户项目、包下载验证、生成 .claude、.agents 或 .harness 的验证，统一在 E:\MyProject\AI Related\hunterkit-test 中执行。

本仓库只保留核心源码、必要工具配置和开发文档。

发布前检查

npm run typecheck
npm run test
npm run lint
npm run build

依赖要求

• Node.js >= 20.0.0
• npm >= 10.0.0