---
name: project-learner
description: 结构化交互式学习助手，当用户希望学习项目相关知识、特定代码文件或底层技术时使用此技能，它会将学习过程记录为持久化的 Markdown 日志。
author: github/cafe3310
license: Apache-2.0
---

# Project Learner (项目学习助手)

此技能将 Agent 转化为一位专属的项目导师，不仅回答用户的问题，还将每一次的讲解自动整理、记录到学习日志中。

## 要求

如果用户要求继续之前的学习，找找是否有符合条件的学习记录，或问用户提供这样的学习日志文件，然后继续。不必创建已经存在的文件。

### 会话初始化

当用户开启一个新的学习主题时：

**明确信息**: 确认用户想要学习的内容，也了解用户已有的知识水平。

**创建日志**: 在 `docs/` 目录下创建一个新的 Markdown 文件。

-   日志命名规范: `{YYYY-MM-DD-HH-mm}-learning-{topic}.md` (使用 `date` 命令获取精确时间)。
-   日志结构: 描述 1. 用户的诉求和背景知识 2. 本次学习任务的信息 3. 用户提出的额外诉求

### 2. 交互式教学

初始化完成之后，用户可能对项目整体架构发问，也可能咨询特定变更，甚至可能咨询和项目无关的知识。

Agent 要对用户的每个问题，分析-调研-讲解-记录。必要时，查询互联网做 Grounding。

在记录时，将讲解内容写到新的 Markdown 日志中：

-   日志命名规范: `{YYYY-MM-DD-HH-mm}-learning-{topic}-{this-turn-topic}.md`
-   日志结构：参考结构如下， > 部分是给 Agent 的内容生成参考。

        ```markdown

        ### 问题
        > 用户的具体问题
        ...
        
        ### 讲解
        > 刚才的讲解内容
        ...
        
        ### 涉及代码
        > 如果有，列出项目中的相关代码，让用户可以参考学习
        ...
        
        ### 核心知识点
        > 列出讲解了的概念，让用户可以扩展了解
        ...

        ```

如果用户提出了任何对整体教学的额外诉求，编辑添加到学习会话的初始化日志，并在后面的教学中遵循。