You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
iTi-Flask/.codex/skills/netx-requirements/SKILL.md

2.1 KiB

name description
netx-requirements Use when working in the netx repository on requirements, feature scope, product boundaries, implementation gap analysis, or docs-to-code traceability for controller, core, desktop, and web/admin surfaces.

netx 需求判断

使用场景

/root/Projects/Mine/netx 中处理这些问题时使用:

  • 判断某能力是否属于当前产品范围。
  • 对照需求和实现。
  • 补功能缺口。
  • 改需求文档。
  • 回答产品边界、产品名、交付形态。

先读

按顺序读取:

  1. docs/specs/requirements.md
  2. docs/specs/traceability.md
  3. docs/specs/architecture.md
  4. 当前源码、Cargo.tomlMakefile

当前产品主语

只使用这些产品主语:

  • netx-controller
  • netx-core
  • apps/netx-desktop
  • web/admin

Gateway 是 netx-core 的 capability不是独立程序。

判断规则

  • 需求判断必须回到当前源码和新规格。
  • 文档说已实现但源码没有入口时,按未实现处理。
  • 源码已有入口但缺真实网络、系统权限或跨平台证据时,按待人工验收处理。
  • 发现真实缺口后,默认继续补齐,不停在报告。
  • 自动化验证和最终人工验收分开汇报。

重构期间

本 skill 描述当前有效结构,不用于阻止已确认的重构。

当重构改变以下内容时,同步更新本 skill 和 docs/specs/requirements.mddocs/specs/traceability.md

  • 产品边界。
  • 程序入口。
  • 目录归属。
  • 能力域划分。
  • 需求状态。
  • 验收口径。

若本 skill 与当前源码或已确认重构目标冲突,以当前源码和重构目标为准,并在同次修改中修正本 skill。

常见陷阱

陷阱 处理
控制面入口不明确 改查 apps/netx-controllercrates/netx-controller
core-gateway 当产品 它只是构建档位
把 Desktop 当网络内核 Desktop 只是本机管理壳
只看文档判断现状 改读 docs/specs/* 和源码
默认安全优先 netx 当前前提是效率和功能优先,安全可配置