JSPM – @modus-ai/modus@0.1.4

Package Exports

@modus-ai/modus

Readme

Modus — Business-grounded AI coding accelerator for CodeBuddy IDE

设计哲学

→ context-aware 不 context-blind         — 编码前先加载业务上下文
→ business-grounded 不 feature-fragmented — 以领域知识驱动 AI
→ spec-driven 不 chat-driven             — 变更有文档，决策有留痕
→ multi-agent 不 single-brain            — 专业分工，各司其职
→ iterative 不 waterfall                 — 随时更新 Skill，随时归档
→ knowledge-compounding 不 cold-start    — 每次执行都在积累，越用越快

快速开始

需要 Node.js 18.0.0 或以上版本。

全局安装 Modus：

npm install -g @modus-ai/modus

进入你的项目目录并初始化：

cd your-project
modus init

然后在 CodeBuddy IDE 中运行：

/modus:init

5 个核心命令

命令	用途
`/modus:init`	分析项目，生成业务/团队/技术三层知识库 + 知识目录
`/modus:vibe`	氛围编程，三级渐进加载业务上下文（`--quick` 快速模式）
`/modus:plan`	功能规划，生成 proposal/design/tasks，支持断点续跑
`/modus:spec`	规范开发，生成 delta specs（场景驱动验收）+ 知识提取
`/modus:harness`	全自动双 Loop 多智能体流程，含知识注入/提取闭环

典型工作流

你: /modus:init
AI: 识别到 3 个业务域：order, payment, user
    生成 Business Skills (Layer 2)...
    生成 modus-team-conventions (Layer 0-T)...
    生成 modus-tech-wiki (Layer 1)...
    生成 modus/knowledge-catalog.md（知识全景索引）
    ✅ 初始化完成 | 建议填写 modus/config.yaml 的 constitution 字段

你: /modus:vibe 帮我给订单模块加一个批量审批接口
AI: [Level 1] 读取知识目录（200 tokens）
    [Level 2] 加载 order 域业务知识（3000 tokens，仅此一个域）
    我来实现批量审批接口...
    📝 Skill 更新建议：发现 OrderStatus.PENDING_REVIEW 状态，建议更新 Skill

你: /modus:harness https://tapd.cn/xxx/stories/view/1234567
AI: [INIT] 注入知识：order[verified] | payment[proven]
    ✅ SubAgent 01 完成 → 01-analysis.md（影响范围: 5 个类 | domains: order,payment）
    🔄 SubAgent 02 执行中...（Sprint 2/3 | token: 3/5 Skill 预算已用）
    ⏳ 并行等待 03/04/05（2/3 完成）
    ✅ Gate C 通过，无 P1/P2
    📚 ARCHIVE 完成 → 提取知识 4 条（decision:1 | pitfall:2 | guideline:1）
    ⏸️ 等待人工 Final Review

知识体系（核心竞争力）

Modus 的知识体系让 AI 从「冷启动」变为「越用越快」：

第1次开发 → 45 分钟（AI 需理解项目背景）
第N次开发 → 15 分钟（knowledge-catalog + proven Skill，精准命中）

三层知识结构：

Layer 0-T modus-team-conventions — 团队约定（代码规范、提交规范）
Layer 1 modus-tech-wiki — 技术知识（架构决策、反模式库，跨项目积累）
Layer 2 modus-biz-* — 业务知识（领域模型、业务规则、API 契约）

知识成熟度： draft → verified → proven（自动提升 + 自动衰减，保持知识库健康）

渐进加载： Level 1（catalog，~~200 tokens）→ Level 2（Skill，~~3000 tokens/个）→ Level 3（代码文件，按需）节省约 59% token。

项目宪法： modus/config.yaml 的 constitution.hard_rules 是所有 SubAgent 的最高优先级约束，一次配置，永久生效。

文档

→ Getting Started: 第一步
→ Commands: 命令详情
→ Concepts: 核心概念（含知识分层架构）
→ Harness: 双 Loop 多智能体原理（含 HANDOFF 协议）
→ Knowledge: 知识体系详解

CLI 命令

modus init              # 初始化项目（生成 .codebuddy/ 文件 + 知识目录）
modus update            # 升级后刷新文件
modus config show       # 查看当前配置
modus config profile    # 选择启用哪些命令
modus config set        # 修改单个配置项

License

MIT