VALORA

The future of software development is not about replacing developers, but amplifying their capabilities with intelligent AI collaboration.

Features • Quick Start • Architecture • Commands • Documentation

______________________________________________________________________

🏛️ 关于VALORA

VALORA（用于编排响应架构的多功能代理逻辑） 是一个基于TypeScript的下一代平台，旨在编排一个复杂的AI代理网络，以自动化整个软件开发生命周期。通过超越简单的“代码生成”，VALORA管理了需求、架构和部署之间的微妙相互作用。VALORA提供智能自动化，同时保持人工监督。

为什么选择VALORA？

智能编排：VALORA坐标 11名专业人工智能代理，从 @铅技术监督 @借调工程师 合规性，确保为每项任务分配合适的专家。

三层灵活性：引擎会根据您的资源进行调整，提供 MCP采样, 指导完成，或 API回退 模式。

分阶段治理：每个项目都遵循严格的 8阶段生命周期从初始化和规划到实施，再到验证和PR创建。

战略优化：为了平衡深度和速度，VALORA分配了特定的LLM（如 GPT-5 用于规划或 克劳德俳句 用于验证）。

VALORA不是开发商的替代品；它是一种高保真度的工具，开发人员通过它来指挥AI代理的完整交响乐。

✨ 特性

🤖 多Agent协作

11名专业人工智能代理 具有独特的专业知识：

@铅 --技术监督和架构
@产品经理 --要求和优先级
@软件工程师-\* --实施专家
@平台工程师 --基础设施和DevOps
@qa --测试和质量保证
@借调工程师 --安全与合规
@用户界面设计师 --设计和可访问性

⚡ 三层执行

针对每个用例的灵活执行模式：

层级	模式	成本
1	MCP采样	免费\*
2	引导式完成	免费
3	API回退	每次使用付费
3	本地型号	免费\\

_\*在Cursor中可用时_ _\*\*需要正在运行的本地模型服务器（例如Ollama）_

无需配置 --立即与您的Cursor订阅配合使用。

💎 模型优化

成本效益的战略人工智能模型分配：

型号	用例
GPT-5思维	深入分析、规划
克劳德·十四行诗	实施、审查
克劳德俳句	快速任务、验证

31%战略•31%执行•38%快速

🔒 安全与合规

企业级安全控制：

凭证保护 --环境变量编辑、输出扫描、敏感文件阻止
指挥警卫 --阻止渗透、网络、评估和远程访问模式
快速注射检测 --通过隔离/编辑对工具结果进行风险评分扫描
MCP硬化 --工具定义验证、工具集漂移检测、审批工作流
供应链强化 --冻结锁文件、阻止安装脚本、漏洞覆盖
审计日志 --具有安全事件跟踪功能的完整操作跟踪

🌳 Worktree仪表板和统计数据

实时查看并行探索：

工作树图面板 --git工作树的实时树视图 valora dash 仪表盘
勘探现状 --带有状态图标的彩色编码分支(▶ 跑步，✓ 完整的，✗ 失败）
会话探索链接 --探索创建链接会话；仪表板在会话详细信息视图中显示探索详细信息（任务、工作树、状态）
工作树使用统计数据 --每会话跟踪工作树创建、并发性和持续时间

┌─ Git Worktrees (3) ──────────┐
│ ● main  abc1234              │
│ ├── exploration/exp-abc-jwt  │
│ │   def5678  ▶ RUNNING       │
│ └── feature/new-api          │
│     ghi9012                  │
└──────────────────────────────┘

🔌 外部MCP集成

连接到 15台外部MCP服务器 经用户批准：

类别	服务器
浏览器/测试	剧作家、Chrome DevTools、BrowserStack
设计	Figma，故事书
开发	GitHub、Serena、Context7
基础设施	Terraform、Firebase、谷歌云
数据	MongoDB，弹性
可观察性	Grafana，深度研究

______________________________________________________________________

🚀 快速开始

先决条件

Node.js 18+

安装

# Install globally
pnpm add -g @windagency/valora          # pnpm
yarn global add @windagency/valora      # yarn
npm install -g @windagency/valora       # npm

# Verify installation
valora --version
# Should output: 2.4.0

项目设置

在项目中初始化VALORA：

cd your-project
valora init         # Minimal setup (.valora/config.json)
valora init --full  # Full setup with override directories

你的第一个命令

# Create an implementation plan
valora plan "Add user authentication with OAuth"

发动机将：

选择合适的代理(@lead)
收集代码库上下文
制定详细的实施计划
提供分步指导

Cursor订阅的配置使用率为零

没有API密钥？没问题发动机使用后立即工作 引导式完成模式:

valora plan "Add dark mode toggle"
# → Generates structured prompt for Cursor AI
# → Uses your Cursor subscription (free)

可选：API配置

对于与云提供商的完全自主执行：

valora config setup --quick

# Or set environment variables
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...

可选：本地模型（无API密钥）

使用Ollama或任何兼容OpenAI的服务器完全离线运行：

# Install and start Ollama
ollama pull llama3.1
ollama serve

# Use it directly
valora plan "Add auth" --provider local --model llama3.1

# Or configure as default
export LOCAL_BASE_URL=http://localhost:11434/v1
export LOCAL_DEFAULT_MODEL=llama3.1

______________________________________________________________________

🏗️ 建筑

┌─────────────────────────────────────────────────────────────────────────┐
│                                 VALORA                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌─────────────┐  ┌──────────────┐  ┌─────────────┐  ┌─────────────┐   │
│   │ CLI Layer   │  │ Orchestrator │  │ Agent Layer │  │ LLM Layer   │   │
│   │             │──│              │──│             │──│             │   │
│   │ • Commands  │  │ • Pipeline   │  │ • Registry  │  │ • Anthropic │   │
│   │ • Wizard    │  │ • Executor   │  │ • Selection │  │ • OpenAI    │   │
│   │ • Output    │  │ • Context    │  │ • Loading   │  │ • Google    │   │
│   │             │  │              │  │             │  │ • Local     │   │
│   └─────────────┘  └──────────────┘  └─────────────┘  └─────────────┘   │
│                                                                         │
│   ┌─────────────┐  ┌──────────────┐  ┌─────────────┐  ┌─────────────┐   │
│   │ Session     │  │ Config       │  │ MCP         │  │ Services    │   │
│   │             │  │              │  │             │  │             │   │
│   │ • State     │  │ • Loader     │  │ • Server    │  │ • Logging   │   │
│   │ • Context   │  │ • Schema     │  │ • Tools     │  │ • Cleanup   │   │
│   │ • History   │  │ • Providers  │  │ • Prompts   │  │ • Utils     │   │
│   └─────────────┘  └──────────────┘  └─────────────┘  └─────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

关键设计原则

原理	实施
模块化	接口清晰的松散耦合组件
可扩展性	代理、命令、提供者的插件架构
可测试性	综合测试套件（单元、集成、e2e）
可观测性	结构化日志记录和会话跟踪
韧性	优雅的回退和错误恢复

______________________________________________________________________

📋 命令

完整的命令参考

命令	代理	描述
`refine-specs`	@产品经理	共同完善规格
`create-prd`	@产品经理	生成产品需求文档
`create-backlog`	@产品经理	将PRD分解为任务
`fetch-task`	@产品经理	检索下一个优先级任务
`refine-task`	@产品经理	明确任务要求
`gather-knowledge`	@lead	分析代码库上下文
`plan`	@lead	创建实施计划
`review-plan`	@lead	验证计划质量
`implement`	动态	执行代码更改
`assert`	@asserter	验证实现
`test`	@qa	执行测试套件
`review-code`	@lead	代码质量审查
`review-functional`	@lead	功能审查
`commit`	@lead	创建常规提交
`create-pr`	@lead	生成拉取请求
`feedback`	@产品经理	记录结果
`consolidate`	@lead	整合和修剪内存存储 _（实验）_

命令类别

┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────────────┐
│ Planning            │  │ Implementation      │  │ Delivery            │
├─────────────────────┤  ├─────────────────────┤  ├─────────────────────┤
│ • refine-specs      │  │ • implement         │  │ • commit            │
│ • create-prd        │  │ • assert            │  │ • create-pr         │
│ • plan              │  │ • test              │  │ • feedback          │
│ • review-plan       │  │ • review-code       │  │                     │
│ • gather-knowledge  │  │ • review-functional │  │                     │
└─────────────────────┘  └─────────────────────┘  └─────────────────────┘

______________________________________________________________________

📚 文档

👤 User Guide

Getting started, workflows, and daily usage

💻 Developer Guide

Architecture, codebase, and contributions

🏛️ Architecture

System design and decisions

文档结构

documentation/
├── README.md                    # Documentation entry point
├── user-guide/                  # For users
│   ├── quick-start.md           # 5-minute getting started
│   ├── workflows.md             # Common patterns
│   └── commands.md              # Command reference
├── developer-guide/             # For developers
│   ├── setup.md                 # Development environment
│   ├── codebase.md              # Code structure
│   └── contributing.md          # How to contribute
├── architecture/                # For architects
│   ├── system-architecture.md   # C4 diagrams
│   ├── components.md            # Component design
│   └── data-flow.md             # Data flow patterns
└── adr/                         # Decision records
    ├── 001-multi-agent-architecture.md
    ├── ...
    ├── 008-pretooluse-cli-enforcement.md
    └── 009-supply-chain-hardening.md

______________________________________________________________________

🎯 用例

新功能开发

valora refine-specs "User authentication with OAuth"
valora create-prd
valora create-backlog
valora fetch-task && valora plan
valora implement
valora review-code && valora commit
valora create-pr

Bug修复工作流程

valora plan "Fix: Login timeout issue"
valora implement
valora test --type=all
valora commit --scope=fix

代码审查

valora review-code --focus=security
valora review-functional --check-a11y=true

______________________________________________________________________

🔧 项目结构

valora/                          # npm package root
├── bin/                         # CLI entry points
│   ├── valora.js                # Main CLI
│   └── mcp.js                   # MCP server
├── src/                         # TypeScript source
│   ├── ast/                     # AST-based code intelligence (tree-sitter parsing, symbol index)
│   ├── cli/                     # Command-line interface
│   ├── config/                  # Configuration management
│   ├── executor/                # Pipeline execution
│   ├── llm/                     # LLM provider integrations
│   ├── lsp/                     # LSP integration (language server protocol client)
│   ├── memory/                  # Biologically-inspired memory (exponential-decay stores)
│   ├── mcp/                     # MCP server implementation
│   ├── security/                # Agentic AI security (credential, command, injection guards)
│   ├── session/                 # Session management
│   │   └── worktree-stats-tracker.ts  # Worktree usage statistics
│   ├── ui/                      # Terminal UI (dashboard, panels)
│   ├── utils/                   # Utilities & path resolution
│   └── ...
├── data/                        # Built-in resources (shipped with package)
│   ├── agents/                  # Agent definitions (11 agents)
│   ├── commands/                # Command specifications (25 commands)
│   ├── prompts/                 # Structured prompts by phase
│   ├── templates/               # Document templates
│   ├── hooks/                   # Hook scripts
│   ├── config.default.json      # Default configuration
│   ├── hooks.default.json       # Default hooks config
│   └── external-mcp.default.json # External MCP server registry
├── dist/                        # Compiled output (gitignored)
├── tests/                       # Test suites
├── documentation/               # Comprehensive docs
└── package.json

项目级别覆盖(`.valora/`)

在项目中安装时，VALORA支持 .valora/ 本地覆盖目录：

.valora/                         # Project-specific configuration
├── config.json                  # Project settings (overrides defaults)
├── agents/                      # Custom/override agent definitions
├── commands/                    # Custom/override command specs
├── prompts/                     # Custom/override prompts
├── templates/                   # Custom/override templates
├── sessions/                    # Session state (gitignored)
├── logs/                        # Execution logs (gitignored)
├── index/                       # Codebase symbol index (gitignored)
├── memory/                      # Agent memory stores (gitignored)
│   ├── episodic.json            #   7-day half-life events and observations
│   ├── semantic.json            #   30-day half-life patterns and insights
│   └── decisions.json           #   21-day half-life architectural decisions
└── cache/                       # Cache data (gitignored)

资源在 .valora/ 优先于内置 data/ 资源。

______________________________________________________________________

🌟 为什么选择VALORA？

传统发展

❌ 工具之间的上下文切换
❌ 手册文档
❌ 代码审查不一致
❌ 重复的提交消息
❌ 耗时的公关创建

通过AI编排

✅ 统一的工作流自动化
✅ 自动生成的文档
✅ 全面的人工智能评论
✅ 智能提交消息
✅ 单命令PR创建

创新亮点

创新	影响
多代理编排	专业代理商生产专家级产品
三层执行	从免费到完全自动化的灵活性
会话保持	上下文在命令之间自然流动
动态代理选择	适合每项任务的专家
质量门	多个检查点防止技术债务

______________________________________________________________________

🛠️ 技术栈

类别	技术
运行时	Node.js 18+，TypeScript 5.x
程序包管理器	pnpm 10.x
构建	tsc，tsc别名
测试	维特斯特，剧作家
LLM SDK	@人工智能/sdk、openai、@谷歌/生成式人工智能
CLI-UI	墨水（反应），粉笔，指挥官
验证	佐德
代码智能	网络树保姆
主控程序	@modelcontextprotocol/sdk

______________________________________________________________________

📄 许可证

______________________________________________________________________

Get Started • Contribute • Learn More

Valora AI

快速接入

详细介绍

🏛️ 关于VALORA

为什么选择VALORA？

✨ 特性

🤖 多Agent协作

⚡ 三层执行

💎 模型优化

🔒 安全与合规

🌳 Worktree仪表板和统计数据

🔌 外部MCP集成

🚀 快速开始

先决条件

安装

项目设置

你的第一个命令

Cursor订阅的配置使用率为零

可选：API配置

可选：本地模型（无API密钥）

🏗️ 建筑

关键设计原则

📋 命令

完整的命令参考

命令类别

📚 文档

文档结构

🎯 用例

新功能开发

Bug修复工作流程

代码审查

🔧 项目结构

项目级别覆盖(.valora/)

🌟 为什么选择VALORA？

传统发展

通过AI编排

创新亮点

🛠️ 技术栈

📄 许可证

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

项目级别覆盖(`.valora/`)