---
name: netx-requirements
description: 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.toml`、`Makefile`

## 当前产品主语

只使用这些产品主语：

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

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

## 判断规则

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

## 重构期间

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

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

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

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

## 常见陷阱

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