Menu
该 skill 定义了 `.Nexus/0-fact/` 代码事实缓存层的 Frontmatter、Logic/UI 双模板、依赖追踪规则与编写边界，目标是让后续 agent 能快速消费稳定事实，而不是反复扫源码。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
该 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 写成：