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

让 AI 按照您的
真实意图 完美产出

HvAOS (Human vs AI OS) 是一个极简、领域无关(Domain-Neutral)的 AI 协同协议与规则模板系统。它作为 AI 在您项目中的“规则运行网关(Gatekeeper)”,通过 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 (意图层)

定义项目的核心定位、目标受众与核心差异点,并在此明确**“反向边界(不做任何多余或偏离方向的事)”**,在源头上砍掉 AI 的发散性偏见。

LAYER 02

02-rules.md (规则层)

建立项目的硬性红线与安全门槛(如严禁提交密钥、特定交互规范)。AI 在任何产出修改前,必须在对话中**显式获得人类的“同意/继续”**许可。

LAYER 03

03-processes.md (流程层)

规划开发或执行的步骤闭环。拒绝盲目修改,强制推行**“方案先行 -> 获得授权 -> 渐进修改 -> 存量防错”**的严密执行环,规避二次 Bug 产生。

LAYER 04

04-context.md (上下文层)

沉淀项目特有的技术栈、踩坑记录与历史负债日志。为 AI 补充足够的项目记忆,确保新产出与旧文件结构完美融合,不脱钩。

LAYER 05

05-acceptance.md (验收层)

硬性准入与准出指标。要求所有改动都必须通过本地格式预检与存量防错校验。只有通过所有红线门槛,AI 方可提交人类进行最后验收。

实时预设沙盒演练

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

Coding Mode
Rules Preview

可视化规则生成器

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

配置您的 OS 参数

生成文件树预览 (Zip Structure)

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

一键唤醒 AI,激活您的 HvAOS

将本地的 `hvaos/` 文件夹复制到任意项目根目录中,然后将下方命令行发给 AI 助手(如 Cursor、Claude Code、Gemini 等),它将自动按流程读取卡片并与您交互启动。

AI 启动初始化指令

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

⚡ 启动过程三部曲:

01

AI 扫描分析

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

02

精简问答对齐

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

03

规则装载与生效

AI 自动填平本地的卡片文件,并为开发工具生成 `.agent/rules/` 以及 IDE 软链接芯片,规则立刻强制生效。