𓂀𓁢𓋹𝔸ℕ𝕌𝔹𝕀𝕊𓋹𓁢𓂀 - 人工智能工作流程的智能指导
将您的AI代理从混乱的编码器转变为具有三种强大功能的智能工作流编排器:
智能工作流管理的三大支柱
智能引导 · 无缝转换 · 存储库模式架构
NPM包 • Docker Hub • 网站
快速启动
选项1:NPX(推荐)
> 添加到MCP客户端配置```json
{
"mcpServers": {
"anubis": {
"command": "npx",
"args": ["-y", "@hive-academy/anubis"],
"env": {
"PROJECT_ROOT": "C:\path\to\projects"
}
}
}
}
### **选项2:Docker(MCP配置)**
**对于Unix/Linux/macOS(mcp.json):**```json
{
"mcpServers": {
"anubis": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-v",
"${PWD}:/app/workspace",
"-v",
".anubis:/app/.anubis",
"hiveacademy/anubis"
]
}
}
}
对于Windows(mcp.json):```json
{
"mcpServers": {
"anubis": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-v",
"C:\path\to\your\project:/app/workspace",
"-v",
"C:\path\to\your\project\.anubis:/app/.anubis",
"hiveacademy/anubis"
]
}
}
}
______________________________________________________________________
## **初始化自定义模式(代理规则)**
> 一旦你让mcp服务器运行,你需要为你正在使用的代理初始化规则(自定义模式)
**支持的代理**: `cursor` • `copilot` • `roocode` • `kilocode`
### **步骤1:初始化智能制导**```
Please initialize Anubis workflow rules for [your-agent-name] by calling the init_rules MCP tool
步骤2:启动工作流程```
Begin a new workflow for [your-project] with Anubis guidance
______________________________________________________________________
## **ROOCODE设置示例**
1-安装MCP服务器:```
{
"mcpServers": {
"anubis": {
"command": "npx",
"args": ["-y", "@hive-academy/anubis"],
"env": {
"PROJECT_ROOT": "C:\\path\\to\\projects"
}
}
}
}
2-然后确保您处于代码模式,并要求它为您生成自定义Anubis模式
Please initialize Anubis workflow rules for roocode by calling the init_rules MCP tool
3-重新加载窗口,您应该在模式下拉列表中看到自定义模式。激活它并让它创建你的第一个任务
4-如果你没有记忆库文件,作为第一项任务,让它为你生成它们。
光标设置示例
对于Cursor用户,这里有一个完整的设置示例:
- 在游标中安装MCP服务器:
- 打开光标设置(Cmd/Ctrl + ,)
- 导航到“扩展”→ “MCP服务器”
- 添加新的服务器配置:```
"anubis": {
"command": "npx",
"args": ["-y", "@hive-academy/anubis"],
"env": {
"PROJECT_ROOT": "C:\path\to\projects"
}
}
1. **初始化游标规则**
- 确保mcp服务器工作正常且处于活动状态。
- 请代理人 `Please initialize Anubis workflow rules for cursor by calling the init_rules MCP tool`.
- 您应该看到在.cursor/rules处生成了一个名为的文件 `000-workflow-core.mdc`
- 转到光标规则,确保规则文件已添加并处于活动状态。
### 现在,您已准备好开始第一项任务🚀.
> 提示:重要的第一步任务是生成内存库文件
> 请代理人 `Please create a task to analyze codebase and generate memory-bank files (ProjectOverview.md, TechnicalArchitecture.md, and DeveloperGuide.md)`
## **Claude代码设置示例**
- 要安装mcp服务器,请使用以下命令 `claude mcp add anubis npx -y @hive-academy/anubis`
> 确保您位于要安装此程序的poject根目录上。
- 要确保正确安装,请运行 `claude mcp list` 您应该看到一个名为的服务器 `anubis`.
- 现在,您需要执行一个非常重要的步骤:
- 下载此规则标记文件 阿努比斯规则
- 将其保存在项目中,例如文件夹名称中 `rules` 以及文件名 `anubis-rules.md`.
- 然后打开CLAUDE.md文件并添加以下内容:
`Anubis Workflow @rules/anubis-rules.md`
______________________________________________________________________
## 🏆 **最新成果(v1.2.11)**
### **存储库模式实施成功** 🎯
**225%完成率** -迁移了9项服务,超过了目标(目标:4项服务)
**已成功迁移服务:**
- ✅ `workflow-guidance.service.ts` -增强的可测试性和可维护性
- ✅ `step-progress-tracker.service.ts` -清洁状态管理
- ✅ `workflow-bootstrap.service.ts` -简化引导过程
- ✅ `progress-calculator.service.ts` -纯业务逻辑功能
- ✅ `step-query.service.ts` -灵活的数据访问策略
- ✅ `step-execution.service.ts` -可靠的执行跟踪
- ✅ `role-transition.service.ts` -一致的角色管理
- ✅ `execution-data-enricher.service.ts` -高效的数据聚合
- ✅ `workflow-guidance-mcp.service.ts` -标准化MCP操作
### **技术卓越成就** 🚀
**95%类型安全** -增强了整个代码库的TypeScript合规性\
**零编译错误** -完全消除TypeScript构建问题\
**可维护性提高75%** -通过存储库模式更清晰地分离关注点
### **MCP协议合规性** 🤖
**多代理支持** -全面的模板系统,用于:
- ✅ **光标IDE** -智能工作流指导集成
- ✅ **GitHub Copilot** -增强的AI助手功能
- ✅ **房间代码** -简化开发工作流程
- ✅ **Kilo代码** -高级自动化支持
### **性能优化** ⚡
**数据库优化** - 434,176 → 421,888字节(优化存储)\
**增强的查询性能** -存储库模式实现了高效的数据访问\
**改进状态管理** -基于ExecutionId的工作流跟踪
______________________________________________________________________
## **🏗️ 卓越建筑**
### **🏆 最近的成就(v1.2.11)**
#### **存储库模式实施成功**
- **225%完成率**:迁移了9项服务,超过了目标(目标:4)
- **95%类型安全**:增强了整个代码库的TypeScript合规性
- **零编译错误**:完全消除TypeScript构建问题
- **可维护性提高75%**:更清晰的关注点分离
#### **服务已成功迁移**
- 工作流指南.service.ts
- 循序渐进的跟踪服务.ts
- workflow-boottrap.service.ts
- 进度计算器.服务.ts
- step-query.service.ts
- step-execution.service.ts
- 角色转换服务.ts
- 执行-数据丰富器.service.ts
- 工作流指南mcp.service.ts
#### **技术亮点**
- ✅ **零TypeScript编译错误** -达到95%的型号安全性
- ✅ **9服务迁移** -超过4个服务目标225%
- ✅ **6存储库实现** -完整的数据访问抽象层
- ✅ **100+存储库方法** -全面的数据库操作
- ✅ **坚实的原则** -具有依赖注入的干净架构
- ✅ **事务支持** -跨复杂操作的数据完整性
#### **利用存储库模式的服务**```typescript
// Example: Service with Repository Pattern
@Injectable()
export class WorkflowGuidanceService {
constructor(
@Inject('IProjectContextRepository')
private readonly projectContextRepository: IProjectContextRepository,
@Inject('IWorkflowRoleRepository')
private readonly workflowRoleRepository: IWorkflowRoleRepository,
) {}
// 75% maintenance reduction through abstraction layer
}
仓库:工作流执行•步骤进度•项目上下文•工作流引导•进度计算•工作流角色
🚀 主要特点
存储库模式架构
- 清洁数据访问层:将业务逻辑与数据持久性分离
- 增强的可测试性:模拟友好的存储库界面
- 符合SOLID原则:依赖倒置和单一责任
- 安全操作类型:全面的TypeScript覆盖率
MCP协议合规性
- 多代理支持:光标、复制副本、RooCode、KiloCode模板
- 标准化交互:官方模型上下文协议实施
- 增强的AI集成:针对LLM工作流自动化进行了优化
性能优化
- 数据库大小缩减: 434176 → 421888 字节优化存储
- 增强的查询性能:存储库模式实现了高效的数据访问
- 改进状态管理:基于ExecutionId的工作流跟踪
核心价值1:人工智能代理的智能引导
您的AI代理会收到每个开发任务的逐步智能规则:```javascript
// Before Anubis: Chaotic, directionless coding
"Create a user authentication system" → Where do I start?
// With Anubis: Intelligent guidance at every step
"Create a user authentication system" →
Requirements Analysis (Researcher Role)
System Architecture (Architect Role)
Enhanced Implementation with Subtasks (Senior Dev Role)
Quality Validation (Code Review Role)
Delivery Preparation (Integration Engineer Role)
**优点:**
- **开发速度提高30-50%** 具有结构化工作流程
- **缺陷减少40-60%** 通过质量门
- **100%符合MCP标准** 指导而非执行
______________________________________________________________________
## **核心价值2:无缝的任务和角色转换**
**在角色或继续任务之间切换时,永远不要失去上下文:**```javascript
// Seamless context preservation across transitions
{
"currentRole": "architect",
"completedSteps": ["requirements", "design"],
"context": {
"decisions": ["JWT for auth", "PostgreSQL for storage"],
"rationale": "Scalability and security requirements",
"nextSteps": ["Enhanced Implementation with Subtasks by Senior Dev role"]
}
}
// → Switch roles without losing any context!
特征:
- 智能上下文保存 角色切换之间
- 自动任务切换 完整的历史
- 基于角色的边界 专注的专业知识
- 暂停和恢复 随时工作流程
智能角色系统
| 角色 | 智能目的 | 关键权力 |
|---|---|---|
| 产品经理 | 战略编排 | 项目设置、任务创建、工作流管理 |
| 建筑师 | 系统设计 | 技术架构、实施规划 |
| 高级开发人员 | 代码表现 | 高质量的实现、测试 |
| 代码审查 | 质量卫士 | 安全验证、性能审查、批准 |
真实世界的例子```javascript
// 1. Agent receives intelligent guidance
const guidance = await get_step_guidance({
executionId: 'auth-system-123',
roleId: 'senior-developer'
});
// 2. Anubis provides structured rules
{
"guidance": {
"step": "Implement JWT authentication",
"approach": [
"1. Create User model with Prisma",
"2. Implement password hashing with bcrypt",
"3. Create JWT token generation service",
"4. Add authentication middleware"
],
"qualityChecklist": [
"SOLID principles applied",
"Unit tests coverage > 80%",
"Security best practices",
"Error handling implemented"
],
"context": {
"previousDecisions": ["PostgreSQL", "JWT strategy"],
"nextRole": "code-review"
}
}
}
// 3. Agent executes with confidence and reports
await report_step_completion({
result: 'success',
metrics: {
filesCreated: 8,
testsWritten: 15,
coverage: 85
}
});
// 4. Quality delivery complete! ✅
______________________________________________________________________
## **技术卓越**
**企业级架构:**
- **后端**:NestJS v11+TypeScript
- **数据库**:Prisma ORM+SQLite/PostgreSQL
- **主控程序**: @rekog/mcp-nest v1.5.2
- **工作流引擎**:存储库模式+DDD架构
- **运行时**:Node.js≥18.0.0
**生产就绪**:
- 符合MCP的架构
- 零执行违规
- 75%的测试覆盖率
- 低于50毫秒的缓存响应
______________________________________________________________________
## 📚 **文档**
- **📖 技术架构** -系统设计和模式
- **🚀 开发者指南** -设置和开发工作流程
- **🎯 项目概述** -业务背景和战略
- **🏗️ 技术架构** -系统设计和模式
______________________________________________________________________
## 🤝 **贡献**```bash
# Development setup
npm install && npm run db:init && npm run start:dev
# Quality checks
npm run test && npm run lint
标准:MCP合规性•SOLID原则•领域驱动设计•循证开发
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
阿努比斯承诺
智能引导 ✨ 无缝转换 ✨ 优质交付
将您的人工智能工作流程从混乱转变为智能。用现代MCP兼容架构为您的代理提供古人的规则。
准备好提升了吗?立即将Anubis添加到您的MCP配置中!