架构设计 预设沙盒 规则生成器 启动引导 GitHub
v1.0.0 Stable

HvAos:一套
以人类意图为主的 AI Agent 驾驭系统

让人类始终掌握目标、边界与验收权。
HvAos (Human vs AI OS) 通过极简的 5 层意图卡片,把 AI 协作从“对话技巧”升级为“可执行、可治理、可复用”的系统能力。

hvaos@panlongio:~

$ hvaos init --domain multiple

[OK] Target directory identified: ~/workspace

[INFO] Reading 5-layer framework template...

[INFO] - 01-intent (意图层) loaded.

[INFO] - 02-rules (规则层) loaded.

[INFO] - 03-processes (流程层) loaded.

[INFO] - 04-context (上下文层) loaded.

[INFO] - 05-acceptance (验收层) loaded.

[WARN] Active Gatekeeper: 02-rules.mdc and 05-acceptance.mdc will enforce strict constraints.

[SUCCESS] HvAos has been successfully loaded into environment!

$ _

5 层卡片架构,帮您给 AI 戴上“金箍”

通过将人机协作拆解为五个清晰的认知维度,显著收敛 AI 的脱缰边界,让它成为您最听话的提效神器。

LAYER 01

01-intent.md (意图层)

【替代产品需求文档 (PRD)】
明确项目使命、目标受众与“绝对不做的事 (Anti-Goals)”,从源头限制 AI 概率生成空间,确保开发意图完全对齐。

LAYER 02

02-rules.md (规则层)

【替代开发规约与红线】
订立硬性开发规范与安全边界。AI 必须在动手前通过 Spec Gate 提交方案并获得人类审批,严禁擅自动手。

LAYER 03

03-processes.md (流程层)

【替代操作 SOP 与更新锁】
硬性规定“先设计、再审批、后执行、必防错”的闭环流程,并锁死非授权规则篡改权限,防止老旧规则陈旧失效。

LAYER 04

04-context.md (上下文层)

【替代系统设计与技术债】
持久化记录专有技术栈与已知债务。AI 在交付时在后台自动更新和修剪(上限 5 条),零冗余,无规则负债。

LAYER 05

05-acceptance.md (验收层)

【替代 DoD 完成定义与预检门禁】
设立严格的质量门禁。未通过格式自测、泄露隐私或遗留临时占位符等成果一律拦截回退,只有完全合格才能提交。

实时预设沙盒演练

点击下方不同领域的预设标签,查看 HvAos 模板在不用场景下的“自适应规则拦截器”输出内容。

Coding Mode
Rules Preview
设计哲学 (Philosophy)

拒绝“规则负债”与“注意力稀释”

像传统自动堆叠或无限生成技能的方案,在运行一段时间后会由于规则累加导致严重的规则负债与语义碰撞。HvAos 采用“5层文件级收敛与自演进”架构,让规则始终保持最高内聚、零冗余。

痛点 (Pain Point 01)

规则负债 (Rule Debt)

AI 不断自动堆叠并写入新的技能规范,导致规则库无休止膨胀。久而久之,陈旧的协议、冗余的代码规约成为沉重的技术债,无论人类还是 AI 都失去阅读和梳理的能力。

痛点 (Pain Point 02)

注意力稀释与语义冲突

当规则分散在海量文件或无结构长文本中时,大模型在长对话时极易出现检索偏差。相似的规则之间发生指令冲突与逻辑碰撞,导致 AI 注意力涣散、陷入幻觉或胡说八道。

HvAos 解法 (The Solution)

五层收敛与自演进

无论项目多复杂,HvAos 永远只维护 5 张高内聚卡片。AI 在交付时自动在后台维护与剪枝(上限 5 条),杜绝多规则匹配重叠。既解决了人肉维护惰性,又防止大模型因窗口过长而失忆变笨。

架构方案深度对比

对比维度 HvAos (人机协作网关) 传统自动堆叠方案 传统无结构 Prompt
规则生命周期与负债 永远收敛为 5 层卡片
对规则进行存量修剪与覆写,零规则冗余,零累积负债
文件数量无限累加
技能越积越多,最终形成庞大而混乱的文档垃圾堆
单文件臃肿或多文件杂乱
规则难以模块化,过长则大模型直接选择性忽视
语义冲突与幻觉控制 极低
5层图层文件级强隔离,结合 MDC 芯片,实现精确的文件路径拦截与挂载

大量规则之间发生重叠或冲突,引起大模型指令混淆,造成决策失准
中到高
无结构的 Prompt 极易导致模型在长上下文中产生注意力涣散和幻觉
维护成本与时效性 AI 交付时自动演进 + 剪枝
免去人肉维护痛苦,低维护门槛,防范老旧规则陈旧失效
无需人类维护,但内容不可控
AI 自主提炼的步骤容易出错,缺乏人类主动对齐和确认机制
完全依赖人类手动重构
一旦项目技术栈重构,规则迅速过时,需要花费精力重写
大模型适配度
(Qwen, Kimi, MiniMax等)
深度优化
专为长上下文和推理模型剪枝,节省 90% 的 Token 上下文税
限制较多
强依赖特定的开源微调基座,在通用商业大模型上容易导致推理脱轨
通用,但极易被淹没
随着对话历史拉长,传统指令极易被长上下文淹没而失效
智能体越权防线 严格的权限边界
AI 仅自动演进上下文/警告,意图与红线修改必须通过 Spec Gate 人类显式审批
无明确边界
AI 在后台拥有过宽的规则自改写权限,容易出现绕过红线行为
无边界
大模型没有明确的自维护边界,随时可能修改或忽视红线约束
开源使命 & 愿景

重塑智能体时代的人机协作秩序,沉淀你的个人数字分身

HvAos 并非一个临时拼接的 Prompt 调试工具。我们致力于通过逻辑解耦和自维护闭环,为全行业提供一套高可靠、低上下文税的通用人机对齐行为规范,并在开发中积攒属于你个人的数字经验资产。

消除 AI 重改折磨,解放人类效率

让 AI 助手真正听懂意图、恪守安全底线。不用再忍受胡说八道和反复回滚的痛苦。

经验“自我生长”,沉淀数字分身资产

5层规则卡片会根据你项目的迭代自动记录踩坑细节。久而久之它将化作你的专属开发灵魂芯片。新项目一键拷贝,AI 瞬间继承你多年累积的全部开发品位,达成极高复用价值。

社区共建蓝图 (Community Roadmap)

01
Stage 1: 5维规则卡片模板 (Current)

打造支持跨 AI IDE(Cursor等)、命令行 CLI(Claude Code)及多智能体框架的通用对齐基础卡片模板。

02
Stage 2: 行业级规则芯片库 (Rules Hub)

联合社区共建丰富的规则库,使开发者能够一键装载诸如 React安全规范、SaaS支付流程对齐等行业最佳实践规约。

03
Stage 3: 开放人机对齐行业标准

推动与主流开源大模型及 Autonomous Agent 生态圈的底层集成,确立开放的人机对齐与拦截行业协议标准。

受够了 AI 乱改代码?点个 Star 一起推动革命! Star on GitHub

可视化规则生成器

输入您的项目参数,自由勾选规则插件,在本地一键打包并下载专属的 HvAos 系统配置。

配置您的 OS 参数

生成文件树预览 (Zip Structure)

  • hvaos-config.zip
    • 01-intent.md
    • 02-rules.md
    • 03-processes.md
    • 04-context.md
    • 05-acceptance.md
    • README-HvAos.md
    • WHITEPAPER.md
    • .hvaos
      • 01-intent.mdc
      • 02-rules.mdc
      • 03-processes.mdc
      • 04-context.mdc
      • 05-acceptance.mdc

一键唤醒 AI,激活您的 HvAos

解压并将规则文件复制到您的项目根目录中,然后将下方命令行发给 AI 助手(如 Cursor、Claude Code、Gemini 等),它将自动按流程读取并与您交互启动。

AI 启动初始化指令

请读取项目里的 README-HvAos.md 文件,并执行其中的【AI 智能启动与初始化协议】。

⚡ 启动过程三部曲:

01

AI 扫描分析

AI 自动递归读取 5 张 Markdown 卡片,分析其中所有的 {{PLACEHOLDERS}} 占位符与空缺信息。

02

精简问答对齐

AI 自动整理并在聊天框中向您发送 3-5 个精简的选择或问答题,帮助您明确当前项目定位与约束红线。

03

规则装载与生效

AI 自动填平本地的卡片文件,并生成 `.hvaos/` 核心目录以及 IDE 软链接芯片,规则立刻强制生效。