From omni
Identifies and adjusts logical entities from defined functions, outputting responsibility boundaries, collaborations, key data structures, and data model docs. Explicitly invoked by design skill.
npx claudepluginhub zte-aicloud/co-omnispec --plugin omniThis skill uses the workspace's default tool permissions.
- 仅被 `design` skill 显式调用
Extracts domain entities from requirements and user stories using DDD principles, defines attributes and constraints, models relationships with cardinality, and documents state machines.
Extracts logical entities from reverse-engineered interfaces, fuses duplicates, generates entity docs, and builds entity-interface relationships. Triggers on reverse --target entities or all.
Designs modular high-level architectures from functional requirements using Balanced Coupling, producing module design docs, integration contracts, and test specs. Use for new systems or architecture documentation.
Share bugs, ideas, or general feedback.
design skill 显式调用include/、source/ 等通用/基础设施类目录视为逻辑实体(除非该目录本身承载明确业务语义且在需求/场景中可追溯)。注意事项:
FEATURE_DIR/spec.md 的功能列表为依据,识别支撑功能所需的逻辑实体,并为每个功能明确:design / design-interface 一致)按以下顺序选用第一个存在的文件作为本次步骤的架构输入;均不存在则不阻塞,不将「缺少架构文件」视为失败,仅在产出中依赖 FEATURE_SPEC、context.md 与 IMPL_DESIGN 已有上下文自行给出分层假设并显式记录:
${DOC_DIR}/on-demand/logic_architecture.md(按需反构,优先)${DOC_DIR}/specs/logic_architecture.md(规格库)下文所称「有效架构约束文档」指按上式解析得到的文件;若未解析到任何文件,则称「未加载架构文档」。
FEATURE_SPEC 与 context.md 做出合理分层假设并在 IMPL_DESIGN 中写明,仍须避免明显跨层反向依赖。FEATURE_DIR/context.md 中的「相关逻辑实体文档」章节,作为既有逻辑实体的主要参考来源。context_mode = evidence_first,优先消费 on_demand.scope、on_demand.traceability、on_demand.risks、on_demand.evidence_gaps,并以 in-scope 功能为实体识别起点。基于步骤1输入与上下文,按「逻辑实体定义」识别并产出本次变更涉及的全部逻辑实体条目(含INSERT/MODIFY/DELETE/REFER),作为后续步骤的范围基线。
动作类型定义:
FEATURE_DIR/context.md 指向的既有逻辑实体文档进行修改。on-demand 实体消费规则(仅 evidence_first 模式):
on_demand.scope 中 in-scope 功能倒推主责/协作实体,限制实体分析范围。on_demand.traceability 保证“需求-功能-接口-实体”链路可追溯,避免孤立实体。on_demand.risks / on_demand.evidence_gaps,在实体边界或数据模型中显式记录假设与约束。兼容规则(default 模式):
context_mode = default 或 on_demand 字段缺失,沿用原有逻辑,不阻塞实体设计。## 逻辑实体
### [动作类型:INSERT/MODIFY/DELETE/REFER] - [逻辑实体ID]([逻辑实体名称])
**变更原因**: [变更来源与采用的方法等]
**支撑的功能**: [功能ID] - [功能名称]
**映射目录**: [逻辑实体的映射目录]
[逻辑实体具体内容]
[按照上述格式继续描述其他实体...]
业务意图 明确需要调整的职责、协作关系或关键属性。对新增或修改的部分使用 **加粗** 标记,对计划移除的内容使用 ~~删除线~~ 标记,以便评审与追踪。DOC_DIR/specs/logic_entities/0.logic_entity_list.md,提取已存在的 ENTITY-XXX 最大ID,取 最大ID + 1 作为新逻辑实体的ID。0.logic_entity_list.md 时,逻辑实体ID从 ENTITY-001 开始。.infra/metamodel/6.entity-template.md 中的规范生成[逻辑实体具体内容]。从既有逻辑实体文档中提取对应条目的关键信息填入模板,变更原因 统一填写为 无变更,仅建立引用关系以支持后续波及分析。
输入:
分析方法:
[NEEDS CLARIFICATION])输出位置:
FEATURE_DIR/data-model.md.infra/templates/data-model-template.mdFUNC-XXX 的主责/协作关系清晰可追溯,能解释其为何存在以及如何支撑场景验收。FEATURE_DIR/data-model.md 覆盖核心数据结构、关键字段与验证规则,并与需求/规则来源具备可追溯关系;状态转换(如适用)描述可执行。ENTITY-XXX ID基于当前最大值顺序递增,无冲突或缺号。