一款针对AI编码代理的技能,通过机械审计强制执行基于规范的开发,确保代码始终通过自动化验证与规范保持一致。

Stars

40

7 天增长

暂无数据

Fork 数

4

开放 Issue

1

开源协议

MIT

最近更新

2026-07-29

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

引入了新颖的“规范锚定”方法,规范和代码共同演化,通过机械门提供机器验证的合规证明,在基准测试中实现了100%的缺陷检测率。

适合谁使用

  • AI编码代理用户(Claude Code、Antigravity)
  • 追求更严格规范遵循的软件开发者
  • 实践规范驱动开发的团队
  • 希望开发流程可审计的工程管理者

典型使用场景

  • 规范并实现功能,保证全程可追溯
  • 通过干净的工作空间隔离并行执行任务
  • 自动审计代码是否符合验收标准
  • 对不可协商规则(如数据隐私)进行项目级宪法检查

项目优势

  • 端到端可追溯性,故事、标准、任务和测试均通过代码关联
  • 机器验证的“完成”——只有通过的测试才算证据
  • 强制记录假设和未决问题
  • 利用git worktree和分支隔离进行有计划并行执行

使用前须知

  • 需要Node.js ≥18以及特定AI代理(Claude Code或Antigravity)
  • 每个项目需要初始设置(npx或手动复制)
  • 基准测试仅限于一个领域(SDD项目);尚未证明更广泛的适用性

README 快速开始

onp-spec-driven

A especificação que continua verdadeira. Você descreve a feature, o agente de IA especifica, planeja, executa em paralelo e prova que fez — com auditoria mecânica, não com promessa. Se a spec e o código desalinham, a máquina acusa.

┌───────────┐  ┌────────┐  ┌───────┐  ┌───────┐  ┌────────┐  ┌───────┐
│ESPECIFICAR│→ │PROJETAR│→ │TAREFAS│→ │ PLANO │→ │EXECUTAR│→ │AUDITAR│
└───────────┘  └────────┘  └───────┘  └───────┘  └────────┘  └───────┘
                                          ↑ paralelismo         ↑ o gate mecânico

Instalação (2 minutos)

A skill é autossuficiente: o motor mecânico já vem embarcado dentro dela (zero dependências — só precisa de Node.js ≥ 18 no ambiente, que seu agente já usa). Instalar é colocar uma pasta no lugar certo. Escolha o seu agente:

Claude Code

Na raiz do seu projeto:

npx @onovoprogramador/onp-spec init --agents claude

Pronto: isso cria a estrutura .spec/ do projeto e instala a skill em .claude/skills/onp-spec-driven/. Abra uma conversa nova no Claude Code e a skill já está ativa.

Antigravity

Na raiz do seu projeto:

npx @onovoprogramador/onp-spec init --agents antigravity

Isso cria a estrutura .spec/ e instala a skill em .agents/skills/onp-spec-driven/ (o diretório de skills do workspace do Antigravity). Abra uma conversa nova e pronto.

Sem npm/npx (instalação manual)

Baixe o repositório e copie a pasta da skill do seu agente:

git clone --depth 1 https://github.com/onovoprogramador/onp-spec-driven.git /tmp/onp-spec

# Claude Code (neste projeto)
mkdir -p .claude/skills
cp -r /tmp/onp-spec/skills/onp-spec-driven .claude/skills/onp-spec-driven

# Antigravity (neste workspace)
mkdir -p .agents/skills
cp -r /tmp/onp-spec/skills/onp-spec-driven-antigravity .agents/skills/onp-spec-driven

Quer a skill disponível em todos os seus projetos? Copie para o diretório global do agente em vez do projeto: ~/.claude/skills/ (Claude Code) ou ~/.gemini/config/skills/ (Antigravity).

Importante: cada agente tem a SUA skill — a do Claude Code executa o plano com sessões headless paralelas do próprio Claude; a do Antigravity usa os agentes paralelos nativos dele. Não misture as pastas (a skill sabe se defender, mas por que arriscar?).

Como usar — você fala, o agente prova

Você **não precisa aprend

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

react
精选
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web 开发前端框架
246,741
tandpfun
精选
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
精选
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI 与机器学习AI 智能体
1,234