system reference

know-yourself-system 快速索引

本文档为共建者提供 know-yourself-system/ 下核心文件的速查索引，方便在创建或修改工具时快速定位所需的规范文档。

文件索引

文件	核心内容
tool-spec.md	五种工具类型的完整定义，包括每种类型的用途、格式要求和内容约束。Skill 主文件元信息的逐字段规范，说明每个元信息字段的含义和填写要求。知识库的组织方式，不同工具类型对应的知识库结构。整份工具清单的维护方式。
output-spec.md	评测报告的标准格式，包含元信息、维度分、总分和解读的结构要求。信念档案的格式定义，记录探索过程中识别出的核心信念及其证据。梦境记录的格式要求，包括梦境描述、元素分析和可能的解读。个人档案的结构，用户长期使用后累积信息的组织方式。进度保存的机制说明。
register-spec.md	注册器 register.md 的扫描规则，说明注册器如何遍历 tools/ 目录。元信息字段的提取方法，注册器从 Skill 主文件中读取哪些字段以及如何读取。map.md 的分类组织方式，工具如何按类型和模型分组排列。
build/build-all.md	从零构建整套体系的完整流程，适用于想要一次性搭建所有工具的场景。包含环境准备、批量创建、统一验证的步骤说明。
build/build-tool.md	构建单个心理学工具的分步指南，适用于只需要新增或修改一个工具的场景。从确定类型到注册的完整流程。
templates/skill-template.md	Skill 主文件的模板，包含元信息区、角色定义、模式判断逻辑和输出格式的占位结构。创建新工具时以此为起点。
templates/knowledge-template.md	知识库文件的模板，包含概念定义、理论背景和应用指南的标准结构。创建知识库文件时参考。
templates/quiz-template.md	题库的模板，包含题目标号、题目正文、选项和维度映射的格式规范。编写评测类工具的题目时使用。

快速理解关键概念

Skill 主文件是每个工具的核心交互文件。它是一个 markdown 文件，AI 在加载后能够从中读取自己的角色定义、行为规则、模式判断逻辑和输出要求。Skill 主文件决定了 AI 在运行该工具时"知道自己在做什么"。每个工具有且只有一个 Skill 主文件，直接放在工具名目录下。

知识库是 Skill 主文件引用的背景知识文件。它存放心理学概念的定义、理论背景、维度解释等内容，AI 在对话过程中需要查阅知识库来理解用户输入并生成准确回应。知识库文件统一放在工具名目录下的 知识库/ 子目录中，可以包含多个文件。Skill 主文件通过文件路径引用知识库中的内容。

产物是工具运行后生成的报告或档案。评测类工具的产物是评测报告，对话探索类工具的产物是探索记录或档案，引导练习类工具的产物是练习记录。产物格式在 output-spec.md 中定义，所有工具输出的产物必须严格遵守相应的格式规范，以保证整个项目的数据一致性。