nova-plugin

中文 | English

---

项目定位

llm-plugins-fusion 用公开、可校验的方式沉淀多项目 AI 编码工作流。当前主交付物是 nova-plugin，通过 Claude Code marketplace 安装和分发，并围绕五阶段工程节奏组织命令、skills、agent 路由和验证边界：

Explore -> Plan -> Review -> Implement -> Finalize

本仓库适合沉淀通用 workflow、consumer profile 契约、脱敏模板、prompt 模板和 capability pack 指南。真实 consumer profile、endpoint、凭据、私有知识库、业务规则和私有仓库地址应保存在 consumer 项目自己的 AGENTS.md、CLAUDE.md、.claude/ 或私有文档中。

当前 marketplace 只是安装与分发机制。本仓库不把当前状态描述为成熟多插件生态，也不把 deferred public portal 当作已实现能力。

快速导航

你是	先读	目标
插件用户	Getting Started	安装 nova-plugin，然后从 Quick Start 或 Command Map 选择命令。
Consumer 项目维护者	Consumer profiles	在私有项目维护 profile，把公开仓库只当作通用 workflow 和模板来源。
插件作者	CONTRIBUTING.md	修改 command / skill 前确认 Skill-first 设计。
维护者	Quality Gates	按变更范围运行校验，并用 release evidence template 记录证据。

当前状态

插件版本	2.2.0
主插件	nova-plugin
命令 / Skills	21 个命令，21 个一对一 skills
Active agents	6 个 core agents，位于 nova-plugin/agents/；8 个 capability packs，位于 nova-plugin/packs/
许可协议	MIT

默认本地质量门是：

node scripts/validate-all.mjs

该入口覆盖 schema、registry fixtures、Claude 兼容性、command / skill frontmatter、core agent 集合、capability pack 结构、hooks、Codex runtime smoke、分发风险扫描、核心回归检查、Markdown 链接、命令文档覆盖和生成 catalog 漂移。Windows PowerShell 可以运行 Node 校验和 scripts/verify-agents.ps1；如果本机没有 Bash，Bash-dependent 检查只能报告为 skipped，不能报告为 passed。

Quick Start

最短上手路径见 docs/getting-started.md。普通 nova-plugin workflow 只需要 Claude Code 插件；维护仓库或运行本地校验需要 Node.js 20+；Codex 闭环命令额外需要本机 Codex CLI 和 Bash。

在 Claude Code 中添加 marketplace 并安装插件：

/plugin marketplace add lliangcol/llm-plugins-fusion
/plugin install nova-plugin@llm-plugins-fusion

确认插件可用：

/plugin

不确定下一步时，从只读路由开始：

/route 这项任务涉及文档、版本和安装验证，请推荐下一步 nova workflow

常规工作流优先使用五个主入口：

/explore -> /produce-plan -> /review -> /implement-plan -> /finalize-work

当前目标	默认命令	说明
先理解问题，不要方案	/explore	收集事实、不确定性和风险信号。
需要可评审计划	/produce-plan	输出正式计划，供后续 review 和 implementation 使用。
审查计划、代码或风险	/review	默认标准级别，可用 `LEVEL=lite
按已批准计划实施	/implement-plan	需要明确的 plan 和 PLAN_APPROVED=true。
交付总结和后续事项	/finalize-work	固化 changed files、validation、限制和 next steps。

nova-plugin 不建议用全局权限绕过作为默认运行方式。写入、Bash 和外部 CLI 流程应通过明确参数、preflight、artifact 范围和验证证据来约束。

Command Map

新用户和 consumer profile 默认优先使用五个主入口：/explore、/produce-plan、/review、/implement-plan、/finalize-work。不确定下一步时先用只读 /route。其它命令保留为高级/兼容入口，不改变既有行为。

阶段	目标	主入口	高级/兼容入口
Explore	选择入口、理解问题、收集事实、暴露不确定性	/route, /explore	/senior-explore, /explore-lite, /explore-review
Plan	输出实现方案或设计文档	/produce-plan	/plan-lite, /plan-review, /backend-plan
Review	审查代码、计划或分支风险	/review	/review-lite, /review-only, /review-strict, /codex-review-only, /codex-verify-only
Implement	按计划实施	/implement-plan	/implement-standard, /implement-lite, /codex-review-fix
Finalize	交付总结、风险、验证与后续事项	/finalize-work	/finalize-lite

Codex 闭环是高级路径，需要 Codex CLI 和 Bash：

/codex-review-only -> 修复 -> /codex-verify-only

也可以使用半自动闭环：

/codex-review-fix

Core Agents + Packs

nova-plugin 的 agent 体系由 6 个短小、route-focused 的 core agents 承担通用职责，再通过 8 个 capability packs 补充领域规则。Packs 是文档化能力包，不做复杂运行时动态加载；已安装插件只作为 enhanced mode，缺失时必须可通过 fallback mode 完成任务。

Core agent	职责
orchestrator	拆解任务、选择 agent + pack、合并结果、发现缺失输入。
architect	架构方案、边界、风险、迁移计划、技术决策。
builder	实现、重构、集成、按计划修改项目文件。
reviewer	代码、设计、安全、质量审查，输出优先级发现。
verifier	测试、静态检查、依赖安全、CI/local validation。
publisher	README、docs、CHANGELOG、release notes、handoff。

Capability packs: java, security, dependency, docs, release, marketplace, frontend, mcp。

Five-Layer Architecture

nova-plugin 可以按五层维护：规则记忆、skill 行为契约、确定性护栏、core-agent 委派和 marketplace 分发。完整说明见 Agent Development Stack。