菜单
项目 docs 知识点沉淀技能：在完成有复用价值的项目问答、代码解释、工作流讲解、设计决策或排错复盘后，把本轮最关键的 1 个知识点写入当前项目 docs/knowledge/ 的单篇 Markdown 文档。Use when: 每次问答结尾、项目知识沉淀、docs 知识库、一个知识点一篇文档、问答复盘、技术概念小白解释、工作流经验记录、代码链路解释记录。不适用于：闲聊、简单确认、纯文件操作、没有可复用知识点的任务。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP.
Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.
Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project.
Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.
| name | project-docs-knowledge-log-zh |
| description | 项目 docs 知识点沉淀技能：在完成有复用价值的项目问答、代码解释、工作流讲解、设计决策或排错复盘后，把本轮最关键的 1 个知识点写入当前项目 docs/knowledge/ 的单篇 Markdown 文档。Use when: 每次问答结尾、项目知识沉淀、docs 知识库、一个知识点一篇文档、问答复盘、技术概念小白解释、工作流经验记录、代码链路解释记录。不适用于：闲聊、简单确认、纯文件操作、没有可复用知识点的任务。 |
只要本工作流将初始化或重组项目，或新建、移动应用、服务、包、模块、页面、API、研究步骤、实验、流水线、测试、文档或多文件产物树，必须先使用 project-structure-architect。
AGENTS.md、PROJECT_STRUCTURE.md、.project-structure.yaml 和现有文件树，锁定项目类型、蓝图及唯一合理路径。BLOCK 时停止结构性写入并先修正或询问用户。纯内容编辑且目标路径已由用户或现有规范唯一确定时，可不重复调用。
把一次问答里最值得复用的知识点，沉淀到当前项目自己的 docs/knowledge/ 中。这个技能只负责项目内长期文档，不替代 knowledge-digest-zh 的最终回复学习摘要。
触发本技能前先做三步判断：
.git、README、docs、src、package.json、pyproject.toml、Cargo.toml、go.mod、pom.xml 等项目特征之一。任一判断不满足时跳过写入。不要因为闲聊、简单确认、纯文件移动、skill 自身维护、没有新知识点的答复而创建文档，除非用户明确要求记录。
docs/knowledge/docs/，在其下创建或使用 knowledge/docs/ 但满足项目特征，创建 docs/knowledge/不要把本技能的项目知识文档写到 skill-outputs/。skill-outputs/ 仍留给一次性总结、报告或其他技能产物。
每次只写 1 个知识点。若本轮出现多个候选，按下面顺序选择：
不要把整轮对话改写成流水账，也不要把多个不相关知识点塞进一篇文档。
使用稳定、可搜索、短小的 slug：
docs/knowledge/<topic-slug>.md
命名规则：
vertical-slice-incremental-build.mdproject-docs-knowledge-log.md- 分隔写入前先快速检查 docs/knowledge/ 中是否已有同主题文档。判断同主题时同时看文件名、一级标题和核心概念，不只看完全同名。
新建文档时使用以下固定结构：
# 知识点标题
## 一句话理解
[用一句话说清楚这个知识点是什么。]
## 为什么本项目会遇到
[说明它和当前项目、当前问题、当前工作流的关系。]
## 小白例子
[用生活化或项目内的简单例子解释，避免抽象术语堆叠。]
## 实战做法
[列出下次遇到类似问题时可以直接照做的步骤。]
## 常见坑
[列出 2-4 个最容易误用或遗漏的点。]
## 下次怎么判断
[给出判断标准：什么时候该用、什么时候不该用、看到什么信号要触发。]
## 关联上下文
- [YYYY-MM-DD] [一句话说明这篇文档来自哪类问答或项目场景。]
更新已有文档时保持以上结构，不要改成聊天记录。把新信息合并进最相关的小节，并在 关联上下文 中追加一条日期记录。
如果写入了文档，在最终回复中用一句话说明路径：
已沉淀知识点文档：docs/knowledge/<topic-slug>.md
如果按触发判断跳过，不需要强行解释；只有用户明确要求记录但本轮不适合记录时，才简短说明跳过原因。