前言¶
周报、项目笔记和零散知识往往堆在 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 页面简介，未在资料中出现的细节不展开。
- 总结并结构化存储：处理周报、笔记、知识等文件，把内容整理成可复用的结构化形式，而不是只留在原始文档里。
- 主动追问补全：发现信息不完整时，向用户追问，减少「半结构化」记忆带来的答非所问。
- 按需检索作答：在需要时从已存储的结构化信息中检索，再基于检索结果回答问题。
- 补充 Agent 记忆体系：定位为 Agent 的「第二记忆大脑」，与现有记忆机制配合，而不是替代整套记忆方案。
- 复杂记忆存取与笔记总结：支持相对复杂的记忆读写流程，并覆盖笔记类材料的总结场景。
安装与启用¶
安装流程以 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 对话中触发。
- 导入材料：把当周周报、项目笔记或知识文档交给 Agent，并说明希望纳入「结构化记忆」；Skill 会按指引做总结与结构化存储。
- 补全缺口：若某周缺少目标、风险或结论等字段，Agent 应会追问；按实回答即可，便于后续检索一致。
- 检索问答：之后在对话中提问（例如某周进展、某主题笔记要点），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
