前言¶

周报、项目笔记和零散知识往往堆在 Markdown 或文档里，Agent 对话时要么读不全上下文，要么只能靠会话窗口里的短期记忆。人工翻文件又慢，字段也不统一。下面介绍 SkillHub 上的 maple-structured-storage（周报结构化记忆总结）：在本地把材料总结成结构化存储，缺信息时会追问补全，需要时再检索出来作答，用作 Agent 的「第二记忆」层。

这是什么¶

maple-structured-storage 是社区来源（community）的 ai-agent 类 Skill，坐标 @user_fb9b2bd3/maple-structured-storage，当前版本 1.0.1，由发布者 user_fb9b2bd3 维护。

一句话定位：对你提供的周报、笔记、知识类文件做总结与结构化落盘，并在对话中按需检索、必要时主动追问以补全缺失信息；官方说明还支持较复杂的记忆读写，并可用于笔记总结。标签标明 requires_api_key=false，不依赖额外 API Key。

SkillHub 展示页：maple-structured-storage。API 入口：官方地址。

核心功能¶

以下能力均来自 SkillHub 页面简介，未在资料中出现的细节不展开。

1. 总结并结构化存储：处理周报、笔记、知识等文件，把内容整理成可复用的结构化形式，而不是只留在原始文档里。
2. 主动追问补全：发现信息不完整时，向用户追问，减少「半结构化」记忆带来的答非所问。
3. 按需检索作答：在需要时从已存储的结构化信息中检索，再基于检索结果回答问题。
4. 补充 Agent 记忆体系：定位为 Agent 的「第二记忆大脑」，与现有记忆机制配合，而不是替代整套记忆方案。
5. 复杂记忆存取与笔记总结：支持相对复杂的记忆读写流程，并覆盖笔记类材料的总结场景。

安装与启用¶

安装流程以 SkillHub 通用说明为准：先具备 skillhub CLI，再把本 Skill 装到当前 Agent 实际使用的 skills 目录（装错目录 Agent 不会加载）。

1、检查或安装 skillhub CLI¶

command -v skillhub && skillhub --version

若未安装，可使用官方安装脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill¶

官方页面给出的安装提示为：依据 SkillHub 安装文档，安装坐标 @user_fb9b2bd3/maple-structured-storage。

命令行示例（--dir 必须指向当前环境的 skills 目录）：

skillhub install @user_fb9b2bd3/maple-structured-storage --dir <skills 目录>

常用客户端的 skills 路径（摘自同一安装文档，按你实际使用的工具选一个）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装到非默认的 ./skills/ 时，需确认 Agent 会扫描该目录；部分环境安装后需重启客户端才能识别新 Skill。

也可将下面这句话发给支持 Skill 的 AI，让其按安装文档完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fb9b2bd3/maple-structured-storage`。

典型用法¶

公开页面未提供逐步截图或固定命令行子工具，典型用法应围绕 Skill 自述的工作流理解，并在 Agent 对话中触发。

1. 导入材料：把当周周报、项目笔记或知识文档交给 Agent，并说明希望纳入「结构化记忆」；Skill 会按指引做总结与结构化存储。
2. 补全缺口：若某周缺少目标、风险或结论等字段，Agent 应会追问；按实回答即可，便于后续检索一致。
3. 检索问答：之后在对话中提问（例如某周进展、某主题笔记要点），Agent 在必要时检索已存结构化信息再回答，而不是每次重读整份原文。

具体字段名、存储路径与检索语法以安装包内 SKILL.md 为准；本文未抓取到该文件正文，不在此处列举未核实的配置项。

适用场景与注意¶

适合谁

• 需要长期积累周报、笔记，又希望 Coding Agent 能「记得住、查得准」的开发者或小团队。
• 已有 Agent 记忆方案，希望加一层面向文档的结构化补充，而不是把所有上下文塞进单次 prompt。

使用注意

• 结构化质量取决于源文档与用户补答；草稿或未归档材料要先整理，否则追问会偏多。
• 安装目录必须与当前 Agent 一致；官方文档强调未用 --dir 指向正确目录时，默认 ./skills/ 可能不被识别。
• 社区 Skill，行为以 1.0.1 包内说明为准；升级可用 skillhub 对同一坐标做更新，并再次确认 skills 目录。
• SkillHub 统计（截至页面抓取）：评分 100000，下载 641，安装 17；热度高不代表适合你的合规与数据留存要求，敏感内容请自行评估本地存储策略。

结尾¶

maple-structured-storage 把周报与笔记从「文件堆」推进到「可追问、可检索的结构化记忆」，适合作为 Agent 的第二记忆层。安装与坐标以 SkillHub 为准：

• 展示页：https://www.skillhub.cn/skills/user_fb9b2bd3/maple-structured-storage
• API：https://api.skillhub.cn/user_fb9b2bd3/maple-structured-storage