Skillget

nexus-harness

agent
Security Audit
Fail
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in nexus_harness/cli.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

A pure-skill, host-agnostic AI engineering harness: PRD → TRD → Plan → TDD → dual-agent review → archive. Works with Claude Code, Cursor & Codex. No MCP required.

README.md

Nexus Harness

Agent = Model + Harness — 给 Cursor / Claude Code / Codex 装上稳定、可验证、可恢复的研发执行环境。
A Harness Engineering toolkit that turns one-off AI conversations into a repeatable, verifiable, resumable engineering workflow.

paradigm
hosts
AIWeave
license

开源地址 · Repository: https://github.com/xurb-nexus/nexus-harness

模型决定「能不能生成」，Harness 决定「能不能交付」。Nexus Harness 不替代任何 AI 编码工具，而是在它们外面包一层研发 Harness：把 PRD → TRD → Plan → TDD 开发 → Review → 归档 → 问题定位 → AIWeave docs 同步 串成一条状态可恢复、质量有证据的工程流水线。纯 skill 化、克隆即用、三端通用、不依赖任何 MCP。

为什么需要它

痛点 Nexus Harness 的做法
AI「看起来写完了」，但没按需求/约束写对 TRD、Plan、TDD gate、lint、preflight、reviewer 把质量前置成证据
流程因人而异，大项目推进就乱 固定 PRD → TRD → Plan → Dev → Review → Finish 一条主链
长任务一换会话就丢现场 进度落 workspace/ context.json STATUS.md，以文件为事实来源
入口/阶段说不清，靠记命令 6 个固定入口，Agent 按产物自动判断下一步
经验难复用 Go 项目长期知识沉淀到业务仓库 docs/（AIWeave），与代码同 git

七大特色能力

这些是 Nexus Harness 与「让 AI 直接写代码」的根本区别——不只追求生成速度，更追求过程可控、质量可查、状态可恢复。

  1. 双 Agent 独立评审 — 生成与评审分离，reviewer 子 Agent 不继承主会话上下文，杜绝「自己说服自己、自己给自己放行」。
  2. TDD 红绿灯驱动 — RED → GREEN → REFACTOR，先定义可验证行为再实现；硬 gate 拦截 mock 假绿灯与「删码跑红」式作弊。
  3. 跨会话状态续跑 — 不依赖对话记忆，从 workspace/ context.json TRD Plan STATUS.md 恢复现场继续推进。
  4. AIWeave docs 双向契约 — Go 项目写代码前读 docs/，写完反向 sync-feature-to-docs 回写，归档时 doc-sync-check 校验漂移。
  5. 工作流钩子 + 会话隔离 — stop hook 把擅自停下的 Agent 自动拉回循环；per-conversation 隔离让多个窗口并行各跑各的项目，互不干扰。
  6. 数据围栏 — 测试默认只读真实库，写操作只能碰本轮自建数据；缺配置即停，绝不静默降级。
  7. ContextPack 三层诊断 — L1 实况 eager-load → L2 TRD 索引 → L3 docs/INDEX.md，已知坑优先命中，排障只读、根因确认后可 Hotfix。

设计理念详见 Harness Engineering。

六个入口

进入业务仓库运行 nexus，回复编号或直接描述目标即可；任意时刻单独输入 nexus 回到入口菜单。

# 入口 用途
1 开始新项目 从一句想法 / 文字描述 / 现成 PRD 出发，苏格拉底追问澄清并生成结构化 PRD
2 继续进行中的项目 读 workspace / context.json / TRD / Plan / STATUS.md，自动判断续 PRD、TRD、Plan、开发还是收尾
3 提取 AI 知识库 Go 项目独立构建或同步 AIWeave docs/：冷启动 / 补缺口 / 检查漂移
4 项目归档 收尾审计；Go 项目先做 docs 最终同步与一致性检查，再迁入 archive/
5 问题定位 基于 ContextPack 装载现场，优先命中已知坑，必要时衔接 Hotfix
6 查看使用说明 打开本地静态文档站，不启动服务、不占端口

AIWeave 集成

vendor 了 AIWeave，作为 Go 项目「代码 ↔ docs 双向契约」的规范源（非 Go 项目自动跳过）。

  • 规范量：28 篇 docs-spec + 18 个 .claude/skills/ 操作手册（new-model / sync-feature-to-docs / doc-sync-check / io-review 等）。
  • 三档成熟度：T0 冷启动建骨架 → T1 补缺口 → T2 检查并按需同步。
  • 正向 / 反向：写前读 docs/ + BUILD_STATUS.md 按契约实现；写后 sync-feature-to-docs 回写、doc-sync-check 校验。
  • 归属与边界：产物写入业务仓库随代码提交；skills/aiweave-bridge/vendor/aiweave/** 为只读上游镜像。

快速开始

前提：已安装 Claude Code（claude 命令可用，见 claude.ai/code）；终端可执行 python3。

# 1. 安装一次（幂等：建目录、加 nexus 软链、提示 PATH）
git clone https://github.com/xurb-nexus/nexus-harness.git
cd nexus-harness && bash install.sh   # 完成后开一个新终端

# 2. 在业务仓库启动
cd /path/to/your-project
nexus                                  # 出现 1–6 菜单；Cursor 用户在 Agent 聊天框输入 nexus

命令速查与路径模型

nexus                  # auto-init + 启动 Claude Code
nexus init             # 在当前项目写/更新适配文件
nexus doctor           # 检查本机安装与环境
nexus cheatsheet       # CLI 速查
nexus uninstall        # 卸载（--dry-run 预览）
变量 默认值 用途
NEXUS_HOME 本仓库 skills / scripts / docs
NEXUS_PROJECT_ROOT 当前目录 业务代码仓库
NEXUS_STATE_ROOT ~/.nexus-harness/state/<project> 运行时状态

文档

open site/public/index.html     # 本地静态文档站（file://，零运行时）

也可在业务项目运行 nexus 后选择 6. 查看使用说明。

参与共建

欢迎通过 issue / PR 参与共建。

许可证

本项目以 Apache License 2.0 开源。

Reviews (0)

No results found