From omni
Analyzes requirement impact by searching DOC_DIR/specs for relevant REQ/SCN/FUNC/API/ENTITY docs and relations/JSON, extracts goals/users/concepts, outputs structured context for FEATURE_DIR/context.md without file writes.
npx claudepluginhub zte-aicloud/co-omnispec --plugin omniThis skill uses the workspace's default tool permissions.
围绕单个功能/需求或变更描述,自动完成**需求波及分析**,输出一份可直接用于填充 `context.md` 的结构化内容。
Creates or updates feature specifications from natural language business intents, automating branch creation, impact analysis, context generation, and quality validation.
Performs requirements analysis: decomposes problems, scans stakeholders, structures and prioritizes needs. Produces 1-requirements.md lifecycle doc before tech-spec. Not for task tickets or solutions.
Share bugs, ideas, or general feedback.
围绕单个功能/需求或变更描述,自动完成需求波及分析,输出一份可直接用于填充 context.md 的结构化内容。
核心目标:
relations/*.json 找到相关/受影响的规格spec-impact-analyze 的分析结果,补充架构视角、术语映射、约束与假设FEATURE_DIR/context.md不做的事情:
FEATURE_DIR/context.md 或其他文件,只返回结构化内容在以下场景使用本技能:
/specify)解耦,由上层命令统一调用本技能context.md 的结构化上下文,而不是散乱的文档列表调用本技能时,应提供:
/specify 中的 $ARGUMENTS)scripts/*/check-prerequisites.* 相同的方式检测,默认 DOC_DIR = omni-docDOC_DIR,本技能内部需:
scripts/powershell/check-prerequisites.ps1 --json --paths-onlyscripts/bash/check-prerequisites.sh --json --paths-onlyDOC_DIR,并派生以下路径:
DOC_DIR/specs/requirements/ → REQ-*.mdDOC_DIR/specs/scenarios/ → SCN-*.mdDOC_DIR/specs/functions/ → FUNC-*.mdDOC_DIR/specs/interfaces/ → API-*.mdDOC_DIR/specs/logic_entities/ → ENTITY-*.mdDOC_DIR/specs/relations/requirements.jsonDOC_DIR/specs/relations/scenarios.jsonDOC_DIR/specs/relations/functions.jsonDOC_DIR/specs/relations/interface.json为增强需求边界识别,本技能支持读取 DOC_DIR/on-demand/ 作为可选优先知识源。必须遵循以下兼容策略:
DOC_DIR/on-demand/ 存在且可形成最小追溯链路(requirement -> function -> interface),进入 evidence_first 模式。default 模式,继续执行原有分析流程,不得中断。探测优先级(从高到低):
DOC_DIR/on-demand/on-demand-existing-function-analysis-*.mdDOC_DIR/on-demand/relations/*.jsonDOC_DIR/on-demand/functions/*.mdDOC_DIR/on-demand/interfaces/*.mdDOC_DIR/on-demand/logic_architecture.md推荐模式判定规则:
relations/branch-function.json 与 relations/function-interface.json 且可解析:优先 evidence_first。branch-function.json 但存在 relations/requirement-function.json,仍可进入 evidence_first。default + 记录 fallback_reason。从输入描述中提取:
context.md)glob_file_search / list_dir 获取以下目录下的所有文档:
requirements/(REQ-*.md)scenarios/(SCN-*.md)functions/(FUNC-*.md)interfaces/(API-*.md)logic_entities/(ENTITY-*.md)id, name, type, file, identifier 等name 与从输入描述提取的关键词做子串/包含匹配(不区分大小写);每命中一个关键词贡献 0.3,同一文档名称项累计上限 0.3。id 与关键词做子串/包含匹配;每命中一个关键词贡献 0.2,同一文档 ID 项累计上限 0.2。Functional(REQ) 0.1,Scenario(SCN) 0.08,Function(FUNC) 0.08,Interface(API) 0.06,Entity(ENTITY) 0.05;若元数据无 type 则按目录/文件名推断类型。在 evidence_first 模式下,除原有文档检索外,额外执行:
relations/*.json 构建边界基线:
branch-function.json 作为功能白名单来源(兼容读取 requirement-function.json)。branch-interface.json 作为接口白名单来源(兼容读取 requirement-interface.json)。function-interface.json 作为功能-接口追溯链路来源。functions/*.md 与 interfaces/*.md 提取:
on-demand-existing-function-analysis-*.md 作为需求级摘要与波及统计补充。边界控制规则:
relations 中被 branch(或兼容 requirement)指向的 function/interface。relations 中出现且无直接证据链支撑的对象。context.md 的结构化结果功能描述:
相关反构文档:
架构分析与设计参考:
术语对齐:
ENTITY-054,ACK → ENTITY-055)约束与假设:
on-demand 扩展结构(统一输出,允许为空):
context_mode: evidence_first 或 defaulton_demand.detected: true/falseon_demand.fallback_reason: 未命中时说明原因(目录不存在/链路不足/文件缺失)on_demand.scope:
requirement_iddirect_functions[]indirect_functions[]interfaces[]on_demand.traceability[]: requirement -> function -> interface 链路on_demand.contract_deltas[]:
interface_idrequest_added[]response_added[]response_modified[]on_demand.risks[]on_demand.evidence_gaps[]输出应以「总结与归纳」为主,而不是简单复制文档原文或罗列文件名。
调用本技能时,应返回一个结构化对象(或等价的 Markdown 结构),其字段尽量与 context-template.md 对齐,方便上层命令直接:
context_mode 与 on_demand.detected 字段,供上层决定是否启用边界锁定策略。default 模式下,on_demand.* 字段可为空数组/空对象,但字段应保留。上层命令(如 /specify)只负责:
FEATURE_DIR/context.md