# Nika Skill 约束（目标技能必须遵循）

本文件描述的是 **Nika 平台运行时对“目标技能文档内容”的约束**。它不约束 `nika-skill-creator` 本体。

## 结构约束（两层）

- 目标技能只允许两层：
  - 主文档（核心流程与契约）
  - 子文档（参考细节）
- 子文档只允许一级，不允许再分层。

## 存储与文件类型

- Nika 的持久化内容主要分两类：
  - 正文写入章节文件
  - 其它信息写入设定文件
- 目标技能必须在“交付物”里明确哪些是章节文件交付，哪些是设定文件交付。

## 引用规则

- 在技能文档内部，`@子文档名` 用于引用本技能的子文档。
- 不要在技能文档里使用“文件路径”或“文件扩展名”的引用形式。
- 禁止在技能文档里用 `@` 去引用用户可自定义名称的文件（例如让用户“保存到@大纲”这种写法）。
  - 正确做法：为目标技能约定固定文件名或命名模式，并在“必要输入/交付物”中写清楚；或用自然语言向用户澄清所需背景信息。

## 输入获取策略（固定优先级）

目标技能必须遵循：
1. 优先使用对话中用户已提供或已引用的内容
2. 否则按“文件类型 + 文件名/命名模式”在设定/章节/笔记中查找
3. 仍找不到才向用户提问，并一次只问关键缺口

## 交付要求（双形态）

目标技能必须同时提供：
- 持久交付：以文件形式交付（章节文件或设定文件），并明确文件名规则与内容结构
- 临时交付：在屏幕输出摘要、检查结果、下一步指引