菜单
该 skill 定义了 `.Nexus/0-fact/` 代码事实缓存层的 Frontmatter、Logic/UI 双模板、依赖追踪规则与编写边界，目标是让后续 agent 能快速消费稳定事实，而不是反复扫源码。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
该 skill 定义了 Investigator 产出功能级预研方案时的正文结构、成熟度要求与判断标准。当功能复杂且必须分阶段落地时，步骤规划必须内嵌在同一份功能级预研文档中，不再单独产出 Feature Step Plan。
该 skill 定义了子智能体在终局返回时必须遵守的协议，以确保明确交代状态，避免静默结束和空响应。
该 skill 定义了 DocWriter 在被明确要求时更新 `doc/**/*` 与 `README.md` 的协议，以确保文档更新有明确来源、明确范围且不越权研究源码。
该 skill 定义了 Generalist 在 `UI Fallback Mode` 下接管 UI 实现时必须遵守的约束，以防止在 UI agent 失效时无边界实现 UI。
该 skill 定义了实现者在完成代码修改后同步 `.Nexus/0-fact/` 的协议，以确保 fact 与真实代码保持一致，并可被 Reviewer 审查。
该 skill 定义了 `.Nexus/3-implement/` 中实现情况文档的编写协议，以确保每条功能 / 每步实现都有清晰、结构化、事实性的记录，方便 Reviewer 验证代码与 fact，并让后续文档流程快速消费。
| name | nexus-fact-cache-comment-style |
| description | 该 skill 定义了 `.Nexus/0-fact/` 代码事实缓存层的 Frontmatter、Logic/UI 双模板、依赖追踪规则与编写边界，目标是让后续 agent 能快速消费稳定事实，而不是反复扫源码。 |
.Nexus/0-fact/ 是代码事实缓存层。
它的存在目标是：
Investigator、Generalist、UI_Investigator、UI_Coder、Reviewer 提供统一可消费的结构化事实当前流程中：
Generalist / UI_Coder 负责在实现完成后同步相关 factReviewer 负责验证 fact 与真实代码是否一致，并检查模板合规性0-fact 采用懒建立：
Reviewer 验证每个实际代码文件对应一个 fact 文档：
src/foo/bar.ts.Nexus/0-fact/src/foo/bar.ts.md规则：
.md0-fact 应该像：
而不是：
[TODO: 需后续实现者或研究者确认]@class、@function、@field、@flow 这种高维护成本的碎片标签depends_on 与 used_by 不是可有可无的装饰项每个 fact 文档顶部必须包含 Frontmatter：
}
字段说明：
path
role
summary
last_synced_from
path 相同last_synced_by
补充规则：
API、Config、Mixed 默认沿用 Logic 模板，除非未来另有专门模板role 无法可靠判断，优先写 Mixed，并在正文中说明原因包括但不限于：
包括但不限于：
适用于 Logic / API / Config / Mixed 中以逻辑为主的文件。
md:{
[exportName]:
[fieldOrStateName]:
[Method] [Path or Contract Name]:
NoneNone[TODO: consumer pending confirmation]None适用于 UI 组件、页面、布局等呈现层文件。
md:{
[ComponentName]:
[propName]:
[callbackName]:
Not ApplicableBasic only[TODO: consumer pending confirmation]None优先记录：
若是 UI 文件，额外优先记录：
Reviewer 在审查 fact 时，至少要检查：
role 是否匹配真实文件职责depends_on / used_by 是否表达了真实依赖关系禁止把 fact 写成：