What makes Harness Dev Standards notable?

1.1K downloads. Trust evidence available

How should Harness Dev Standards be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Harness Dev Standards

Provides a full-cycle, automated quality gate and governance framework to ensure standardized, error-free code delivery in Harness Engineering projects. Skill: Harness Dev Standards Owner: ai-acheng Summary: Provides a full-cycle, automated quality gate and governance framework to ensure standardized, error-free code delivery in Harness Engineering projects. Tags: latest:1.0.3 Version history: v1.0.3 | 2026-08-17T08:56:38.446Z | auto - Added new directories/files: marketing, references, and scripts to enhance documentation and automation. - Removed skill-card.md to s

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.3release · observed Aug 17, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17e1hdx8tza0g6m8aaym7p9ex84vv0m:harness-dev-standards

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ai-acheng-harness-dev-standards/snapshot"

Documentation

CLAWHUB

132,720 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: harness-dev-standards
description: Harness Engineering 开发规范体系 - 全流程质量门禁与自动治理标准。基于企业级全AI研发实践改进，提供完整的代码交付质量保障框架。Use when: (1) 启动新项目开发前, (2) 代码交付前做质量检查, (3) 需要标准化开发流程, (4) 执行架构评审、代码评审, (5) 排查依赖/环境问题
---

# Harness Engineering 开发规范体系

## 核心哲学

> **"质量不是检查出来的，是构建出来的"**

基于 Harness Engineering 理念 + 企业级全AI研发实践，构建从需求到交付的全链路质量保障体系。

---

## 🚀 快速启动

### 新项目初始化检查清单

**每次启动新项目必须执行：**

```bash
# 1. 检查目录结构是否符合标准
# 2. 检查 package.json 依赖完整性
# 3. 检查 .env.example 配置完整性
# 4. 检查 README 文档完整性
```

---

## 🔐 质量门禁 (Quality Gates)

**每次交付必须通过以下 6 道门禁：**

### 1. 需求门禁 (Requirement Gate)
- ✅ 需求完整清晰，无模糊点
- ✅ 所有需求点已记录到任务追踪
- ✅ 技术可行性已验证
- ✅ 依赖边界已明确

### 2. 架构门禁 (Architecture Gate)
- ✅ 技术选型适合单人开发
- ✅ 文件结构清晰，符合标准化规范
- ✅ 依赖最小化，无冗余包
- ✅ 扩展性设计合理

**参考：** 查看 [references/standards.md](references/standards.md) 标准化文件结构

### 3. 编码门禁 (Coding Gate)
- ✅ 语法正确，无 TypeScript/JavaScript 错误
- ✅ import 路径全部正确
- ✅ 命名规范清晰（camelCase 变量、PascalCase 组件）
- ✅ 不遗漏任何功能点
- ✅ 类型定义完整，无 `any` 滥用

### 4. 依赖门禁 (Dependency Gate)
- ✅ package.json 包含所有需要的依赖
- ✅ 无多余依赖（`depcheck` 验证）
- ✅ 依赖版本稳定（非 alpha/beta）
- ✅ lockfile 已提交（pnpm-lock.yaml / package-lock.json）

**工具：** 运行 `scripts/depcheck.sh` 自动检查

### 5. 环境门禁 (Environment Gate)
- ✅ .env.example 包含所有需要的配置
- ✅ 每个配置项有说明注释
- ✅ 敏感信息不提交到 git
- ✅ .gitignore 配置正确

### 6. 交付门禁 (Delivery Gate)
- ✅ 所有需求点都已实现
- ✅ 项目能正常启动
- ✅ README 写清楚使用方法
- ✅ 构建无错误（`npm run build` 验证）

---

## 🤖 自动治理 (Auto Remediation)

出现以下问题时，**自动修复，无需人工干预：**

| 问题类型 | 自动修复策略 |
|---------|------------|
| 依赖安装报错 | 分析错误 → 修改版本号或移除多余依赖 |
| import 路径错误 | 自动查找正确路径修复 |
| 语法错误 | 自动修正 TypeScript/JavaScript 语法 |
| 启动失败 | 读取错误日志 → 修复后重新检查 |
| 类型错误 | 补全类型定义或修正类型不匹配 |

**修复流程：**
1. 识别错误信息
2. 定位问题代码位置
3. 应用修复策略
4. 验证修复结果
5. 重复直到问题解决

---

## 📁 标准化文件结构

### Next.js 项目标准结构

```
project-name/
├── app/                    # Next.js App Router
│   ├── page.tsx            # 首页
│   ├── layout.tsx          # 全局布局
│   └── globals.css         # 全局样式
├── lib/                   # 工具库、第三方客户端
├── public/                 # 静态资源
├── .env.example            # 环境变量示例
├── .gitignore              # git忽略规则
├── package.json
├── tsconfig.json
├── README.md               # 必须写清楚
└── *-init.sql              # 数据库初始化SQL
```

**README 必须包含：**
- 项目介绍
- 配置步骤
- 启动命令
- 环境变量说明

**详细规范：** 查看 [references/standards.md](references/standards.md)

---

## ✅ 代码质量标准

### TypeScript 规范

- ✅ 类型正确，无隐式 `any`
- ✅ 命名清晰，变量名表达用途
- ✅ 注释够用，不冗余
- ✅ 函数单一职责
- ✅ 避免深层嵌套（超过 3 层考虑重构）

### 项目规范

- ✅ README 完整，新人能按文档启动
- ✅ 环境配置说明清晰
- ✅ 依赖干净，无未使用包
- ✅ gitignore 正确，不提交敏感文件

---

## 🛠️ 内置工具脚本

### 依赖检查脚本
```bash
# 运行依赖检查
./scripts/depcheck.sh
```

功能：
- 检测未使用的依赖
- 检测缺失的依赖
- 检测版本冲突
- 生成修复建议

### 代码质量扫描脚本
```bash
# 运行代码质量扫描
./scripts/quality-scan.sh
```

功能：
- TypeScript 类型检查
- ESLint 规则检查
- 命名规范检查
- import 路径验证

---

## 📋 交付前检查清单

**交付前逐项确认：**

- [ ] 需求门禁：所有需求点实现完毕
- [ ] 架构门禁：文件结构符合标准
- [ ] 编码门禁：无语法/类型错误
- [ ] 依赖门禁：依赖干净无冗余
- [ ] 环境门禁：.env.example 完整
- [ ] 交付门禁：项目能正常启动构建
- [ ] README：包含完整使用说明

---

## 📚 参考文档

| 文档 | 内容 |
|-----|------|
| [references/standards.md](r

_meta.json

{
  "ownerId": "kn7ffzw77tj6c8yw14p92w963984vgsq",
  "slug": "harness-dev-standards",
  "version": "1.0.3",
  "publishedAt": 1786956998446
}

references/checklist.md

# 完整交付检查清单

## 目录

- [项目交付前检查清单](#项目交付前检查清单)
- [代码评审检查清单](#代码评审检查清单)
- [发布前检查清单](#发布前检查清单)
- [安全检查清单](#安全检查清单)

---

## 项目交付前检查清单

### 📋 需求检查

- [ ] 所有需求点已实现
- [ ] 需求变更已记录
- [ ] 边缘情况已处理
- [ ] 用户验收标准已满足

### 🏗️ 架构检查

- [ ] 文件结构符合标准化规范
- [ ] 无冗余目录或文件
- [ ] 依赖关系清晰
- [ ] 模块划分合理

### 💻 代码质量检查

- [ ] TypeScript 类型检查通过 (`tsc --noEmit`)
- [ ] ESLint 检查通过无错误
- [ ] 无未使用的变量或导入
- [ ] 无 `any` 类型滥用
- [ ] 命名清晰符合规范
- [ ] 注释充分且有意义
- [ ] 无重复代码块
- [ ] 函数单一职责（不超过 50 行）
- [ ] 嵌套层级不超过 3 层

### 📦 依赖检查

- [ ] package.json 包含所有依赖
- [ ] 无未使用的依赖 (`depcheck` 验证)
- [ ] 依赖版本稳定（非 alpha/beta/rc）
- [ ] lockfile 已提交
- [ ] 无已知安全漏洞 (`npm audit` 验证)

### 🌍 环境检查

- [ ] .env.example 包含所有配置项
- [ ] 每个配置项有说明注释
- [ ] .env.local 已加入 .gitignore
- [ ] 敏感信息未提交到 git
- [ ] .gitignore 配置正确

### 📖 文档检查

- [ ] README.md 完整
- [ ] README 包含项目介绍
- [ ] README 包含快速开始指南
- [ ] README 包含环境变量说明
- [ ] README 包含部署说明
- [ ] 代码注释清晰易懂
- [ ] API 文档（如有）已更新

### ✅ 功能验证

- [ ] 项目能正常启动
- [ ] 项目能正常构建 (`npm run build`)
- [ ] 主要功能流程可正常执行
- [ ] 错误边界已处理
- [ ] 加载状态有反馈

---

## 代码评审检查清单

### 代码正确性

- [ ] 逻辑正确，无明显 bug
- [ ] 边界条件已处理
- [ ] 错误处理完善
- [ ] 异步操作正确处理
- [ ] 并发问题已考虑

### 代码质量

- [ ] 代码简洁，无冗余
- [ ] 命名清晰，表达准确
- [ ] 函数/类职责单一
- [ ] 无重复代码
- [ ] 无魔法数字/字符串

### 性能考虑

- [ ] 无不必要的重渲染
- [ ] 大数据量场景已优化
- [ ] 内存泄漏风险已检查
- [ ] 网络请求有缓存策略

### 安全性

- [ ] XSS 风险已处理
- [ ] SQL 注入风险已处理
- [ ] 用户输入已验证
- [ ] 敏感信息未日志输出
- [ ] 认证授权逻辑正确

### 可维护性

- [ ] 代码结构清晰
- [ ] 注释充分
- [ ] 符合团队规范
- [ ] 测试用例充分

---

## 发布前检查清单

### 构建检查

- [ ] 生产构建无错误
- [ ] 构建产物大小合理
- [ ] Tree shaking 生效
- [ ] 无用代码已移除

### 配置检查

- [ ] 生产环境配置正确
- [ ] API 端点指向生产
- [ ] Debug 模式已关闭
- [ ] Log 级别配置正确

### 功能检查

- [ ] 冒烟测试通过
- [ ] 核心功能验证通过
- [ ] 回归测试通过
- [ ] 性能指标达标

### 监控检查

- [ ] 错误监控已配置
- [ ] 性能监控已配置
- [ ] 日志收集已配置
- [ ] 告警规则已设置

### 回滚准备

- [ ] 上一版本备份存在
- [ ] 回滚流程已明确
- [ ] 数据库迁移可回滚
- [ ] 配置回滚方案已准备

---

## 安全检查清单

### 认证与授权

- [ ] JWT secret 足够复杂
- [ ] Token 过期时间合理
- [ ] 权限边界清晰
- [ ] 越权访问已防护
- [ ] 登录失败有锁定机制

### 输入验证

- [ ] 所有用户输入已验证
- [ ] 验证在服务端执行
- [ ] 输入长度有限制
- [ ] 特殊字符已处理
- [ ] 文件上传有类型/大小限制

### 输出编码

- [ ] XSS 防护已启用
- [ ] HTML 输出已编码
- [ ] JSON 输出正确
- [ ] 响应头安全配置

### 数据保护

- [ ] 密码已加密存储（bcrypt/argon2）
- [ ] 敏感数据传输使用 HTTPS
- [ ] 数据库连接信息加密
- [ ] 日志不含敏感信息
- [ ] PII 数据有保护措施

### 依赖安全

- [ ] 定期运行 `npm audit`
- [ ] 高危漏洞已修复
- [ ] 不使用已废弃的包
- [ ] 依赖来源可信
- [ ] 有依赖更新机制

---

## 自动检查脚本使用说明

### 运行全部检查

```bash
# 进入项目目录
cd your-project

# 运行质量扫描
bash scripts/quality-scan.sh
```

### 单独运行检查

```bash
# TypeScript 类型检查
npx tsc --noEmit

# ESLint 检查
npx eslint . --ext .ts,.tsx

# 依赖检查
npx depcheck

# 安全漏洞检查
npm audit

# 构建检查
npm run build
```

### 检查结果判定

| 检查项 | 通过标准 |
|--------|---------|
| TypeScript | 0 errors |
| ESLint | 0 errors, warnings 可接受但尽量少 |
| depcheck | 0 unused dependencies |
| npm audit | 0 critical, 0 high |
| build | 成功完成无错误 |

---

## 常见问题排查

### 依赖安装失败

1. 检查 Node.js 版本是否符合要求
2. 删除 lockfile 和 node_modules 重新安装
3. 检查网络连接和 npm 源配置
4. 尝试降级有问题的依赖版本

### 类型检查失败

1. 检查类型定义是否完整
2. 检查 import 路径是否正确
3. 检查 tsconfig.json 配置
4. 必要时使用 `// @ts-ignore` 但要加注释说明

### 构建失败

1. 检查环境变

references/remediation.md

# 常见问题自动修复策略库

## 目录

- [依赖问题修复](#依赖问题修复)
- [TypeScript 类型错误修复](#typescript-类型错误修复)
- [Import 路径错误修复](#import-路径错误修复)
- [语法错误修复](#语法错误修复)
- [启动失败修复](#启动失败修复)
- [构建错误修复](#构建错误修复)

---

## 依赖问题修复

### 问题 1: 依赖版本冲突

**错误信息：**
```
npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve dependency
```

**自动修复策略：**

1. **识别冲突包** - 从错误信息中提取冲突的包名和版本范围
2. **查看 peerDependencies** - 检查冲突包的对等依赖要求
3. **应用以下修复方案：**

   **方案 A: 使用 --legacy-peer-deps（临时方案）**
   ```bash
   npm install --legacy-peer-deps
   # 或
   pnpm install --no-strict-peer-dependencies
   ```

   **方案 B: 升级/降级冲突包**
   - 查找兼容的版本组合
   - 更新 package.json 中的版本号
   - 重新安装

   **方案 C: 使用 overrides（npm）或 resolutions（pnpm）**
   ```json
   // package.json
   {
     "overrides": {
       "react": "^18.0.0"
     }
   }
   ```

4. **验证修复** - 重新运行 install 确认问题解决

---

### 问题 2: 未使用的依赖

**错误信息：**
```
Unused dependencies found:
- package-a
- package-b
```

**自动修复策略：**

1. **二次确认** - 检查代码中是否真的没有使用这些包
   - 搜索 import 语句
   - 搜索 require 调用
   - 检查配置文件中的引用

2. **安全移除** - 如果确认未使用：
   ```bash
   npm uninstall package-a package-b
   # 或
   pnpm remove package-a package-b
   ```

3. **注意事项**
   - 不要移除仅在配置文件中引用的包
   - 不要移除 peerDependencies 中声明的包
   - 某些包可能通过字符串动态导入，需要特殊处理

---

### 问题 3: 缺失的依赖

**错误信息：**
```
Cannot find module 'missing-package'
```

**自动修复策略：**

1. **识别缺失包名** - 从错误信息提取
2. **检查是否为 devDependency** - 有些包可能只在开发环境需要
3. **安装依赖**：
   ```bash
   npm install missing-package
   # 或开发依赖
   npm install -D missing-package
   ```

4. **特殊情况处理**
   - 如果是类型定义缺失：`npm install -D @types/missing-package`
   - 如果是 monorepo 内部包：检查 workspace 配置
   - 如果是私有包：检查 npm registry 配置

---

### 问题 4: 安全漏洞

**错误信息：**
```
npm audit found 3 high severity vulnerabilities
```

**自动修复策略：**

1. **运行自动修复**：
   ```bash
   npm audit fix
   ```

2. 如果自动修复无法解决：
   - 查看漏洞详情：`npm audit`
   - 检查受影响包的最新版本是否修复
   - 如果有修复版本，手动升级：`npm update vulnerable-package`
   - 如果无法升级，考虑使用替代包或添加忽略说明

3. **记录说明** - 如果必须保留有漏洞的版本，在代码中添加注释说明原因

---

## TypeScript 类型错误修复

### 问题 1: 隐式 any 类型

**错误信息：**
```
Parameter 'x' implicitly has an 'any' type.
```

**自动修复策略：**

1. **推断类型** - 根据参数使用方式推断合理的类型
2. **添加类型注解**：
   ```typescript
   // 修复前
   function process(x) { ... }
   
   // 修复后
   function process(x: string) { ... }
   ```

3. **如果类型确实不确定**：
   - 使用 `unknown` 而不是 `any`
   - 添加类型守卫
   ```typescript
   function process(x: unknown) {
     if (typeof x === 'string') {
       // x 在这里是 string 类型
     }
   }
   ```

---

### 问题 2: 类型不匹配

**错误信息：**
```
Type 'string' is not assignable to type 'number'.
```

**自动修复策略：**

1. **分析上下文** - 确定期望的类型和实际的类型
2. **应用类型转换**：
   ```typescript
   // 修复前
   const count: number = params.count;
   
   // 修复后
   const count: number = Number(params.count);
   ```

3. **常见转换模式**：
   - 字符串转数字：`Number(x)` 或 `parseInt(x, 10)`
   - 任意转布尔：`Boolean(x)` 或 `!!x`
   - 联合类型收窄：使用类型守卫

---

### 问题 3: 可能为 null/undefined

**错误信息：**
```
Object is possibly 'null'.
Object is possibly 'undefined'.
```

**自动修复策略：**

1. **添加空值检查**（推荐）：
   ```typescript
   // 修

references/standards.md

# 详细文件结构与命名规范

## 目录

- [Next.js 项目标准结构](#nextjs-项目标准结构)
- [Node.js 后端项目结构](#nodejs-后端项目结构)
- [React 组件库项目结构](#react-组件库项目结构)
- [命名规范](#命名规范)
- [Git 提交规范](#git-提交规范)

---

## Next.js 项目标准结构

### 完整目录树

```
project-name/
├── app/                              # App Router 目录
│   ├── (auth)/                       # 路由组 - 认证相关
│   │   ├── login/
│   │   │   └── page.tsx
│   │   └── register/
│   │       └── page.tsx
│   ├── (dashboard)/                  # 路由组 - 仪表板
│   │   ├── layout.tsx
│   │   └── page.tsx
│   ├── api/                          # API 路由
│   │   └── hello/
│   │       └── route.ts
│   ├── layout.tsx                    # 根布局
│   ├── page.tsx                      # 首页
│   └── globals.css                   # 全局样式
├── components/                       # 可复用组件
│   ├── ui/                           # 基础 UI 组件 (Button, Input, etc.)
│   │   ├── button.tsx
│   │   └── input.tsx
│   ├── layout/                       # 布局组件
│   │   ├── header.tsx
│   │   └── sidebar.tsx
│   └── features/                     # 业务组件
│       └── user-profile.tsx
├── lib/                             # 工具库
│   ├── utils/                        # 通用工具函数
│   │   └── format.ts
│   ├── hooks/                        # 自定义 Hooks
│   │   └── use-local-storage.ts
│   ├── types/                        # TypeScript 类型定义
│   │   └── index.ts
│   └── clients/                      # 第三方客户端
│       ├── supabase.ts
│       └── openai.ts
├── public/                           # 静态资源
│   ├── images/
│   ├── icons/
│   └── favicon.ico
├── styles/                           # 样式文件
│   └── theme.css
├── .env.example                      # 环境变量示例
├── .env.local                        # 本地环境变量 (gitignore)
├── .gitignore
├── package.json
├── pnpm-lock.yaml / package-lock.json
├── tsconfig.json
├── next.config.js
├── tailwind.config.js (可选)
├── README.md
└── *-init.sql                        # 数据库初始化SQL
```

### 文件命名规则

| 类型 | 命名规范 | 示例 |
|------|---------|------|
| 页面组件 | kebab-case + page.tsx | `user-profile/page.tsx` |
| UI 组件 | PascalCase | `Button.tsx`, `UserCard.tsx` |
| Hook 函数 | camelCase, use- 前缀 | `use-local-storage.ts` |
| 工具函数 | camelCase | `format-date.ts` |
| 类型定义 | PascalCase | `User.ts`, `ApiResponse.ts` |
| 配置文件 | dot notation | `.eslintrc.js`, `tailwind.config.js` |

---

## Node.js 后端项目结构

```
backend-project/
├── src/
│   ├── controllers/                  # 控制器层
│   │   └── user.controller.ts
│   ├── services/                     # 业务逻辑层
│   │   └── user.service.ts
│   ├── repositories/                 # 数据访问层
│   │   └── user.repository.ts
│   ├── routes/                       # 路由定义
│   │   └── user.routes.ts
│   ├── middleware/                   # 中间件
│   │   └── auth.middleware.ts
│   ├── models/                       # 数据模型
│   │   └── user.model.ts
│   ├── types/                        # 类型定义
│   │   └── index.ts
│   ├── utils/                        # 工具函数
│   │   └── validator.ts
│   ├── config/                       # 配置文件
│   │   └── database.ts
│   └── app.ts

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.