Skip to content

Latest commit

 

History

History
52 lines (42 loc) · 2.03 KB

AGENTS.md

File metadata and controls

52 lines (42 loc) · 2.03 KB

UltraVibe 双闭环无人值守开发套件

交互要求

  • 思考、对外回答全程中文,禁止大段英文、纯英文回复
  • 风格专业犀利、简明扼要、直击核心关键

架构说明(P0-1/P0-2 增强)

入口层 => 路由层 => 执行层 + 公共层 + TypeScript 调度器

  • 入口层: .codex/instructions.md 命令映射
  • 路由层: ultravibe/SKILL.md 意图识别 5 分类
  • 执行层: ultravibe-bugfix|feature|refactor|review/SKILL.md
  • 公共层: ultravibe-common/ preflight/gate/commit
  • 调度器: src/ TypeScript 机械执行引擎
  • 生成原语桥接(P0-1): generation-request → 子代理生成 → apply-generation 写前拦截

驱动循环(P0-2)

uv run 是唯一驱动循环入口:

  1. uv run → 读取 checkpoint → 执行阶段(机械执行器)
  2. 需要 LLM 生成 → 暂停,输出 .reports/generation-request.json
  3. Codex 主会话 spawn 子代理,子代理产出补丁
  4. uv apply-generation 写前校验白名单,通过则 apply
  5. 重新 uv run 继续推进
  6. LLM 唯一自由度 = 生成原语里写代码,其余全机械

斜杠命令

命令 效果
/uv <描述> 意图识别路由
/uv run <flow> 直接执行调度器(统一驱动循环)
/uv status 查看工作流状态
/uv bugfix Bug 修复流程
/uv feature 功能开发流程
/uv refactor 重构流程
/uv review 代码审查

权限声明

[permissions] writable: src/ tests/ .reports/ readonly: CONSTITUTION.md .harness.md *.json protected_files forbidden: git push / git reset --hard / git clean -fd

核心原则

  • 简洁优先:每次变更尽量简单,只影响最小代码
  • 绝不偷懒:找到根因,不用临时修复
  • 最小影响:只修改必要部分,避免引入新 bug
  • 机械执行:调度器/门禁/验证不依赖 LLM 判断
  • 生成原语化:需要 LLM 的地方通过 generation-request/apply-generation 桥接(P0-1)
  • 上下文预算化:phase-enter 含 token 预算硬上限,超预算强制压缩(P1-3)