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

70 lines
2.1 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
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 当前前提是效率和功能优先,安全可配置 |