← 返回 Skills 市场
346
总下载
1
收藏
2
当前安装
8
版本数
在 OpenClaw 中安装
/install reading-tracker
功能描述
个人阅读管理与笔记系统。用于记录读书进度、管理书摘与思考、生成阅读报告。支持渐进式阅读法:书摘记录→每周回顾→月度串联。触发词:"开始读"、"记录书摘"、"阅读进度"、"读完"、"复习"、"本月读了什么"。
安全使用建议
This skill appears coherent and local-only: it stores notes and schedule data under ~/.qclaw/workspace/reading and uses an included Python CLI to manage files and generate reports. Before installing, consider: 1) Privacy — your reading notes are stored unencrypted in your home directory; if they contain sensitive info, back them up or encrypt them yourself. 2) Inspect the included script (scripts/reading_cli.py) to confirm behavior — it appears to do only local file I/O and scheduling data updates. 3) Cron behavior — the SKILL.md contains a cron schedule for weekly review triggers; confirm your agent/platform will handle these events as you expect and that no external delivery channel is configured. 4) Cross-device/sync — there is no network sync built in; if you want syncing, use a trusted mechanism. If you want, I can fully review the truncated portion of the generate-report code or search for network calls or exec usage before you install.
功能分析
Type: OpenClaw Skill
Name: reading-tracker
Version: 0.0.2
The reading-tracker skill bundle is a legitimate tool for managing personal reading notes and schedules. The core logic in 'scripts/reading_cli.py' performs standard file I/O operations within a dedicated local workspace (~/.qclaw/workspace/reading) and uses only standard Python libraries. There is no evidence of data exfiltration, malicious command execution, or harmful prompt injection; all instructions in 'SKILL.md' and 'references/' are strictly aligned with the stated purpose of tracking books and generating reading reports.
能力评估
Purpose & Capability
Name/description (reading tracker, notes, spaced repetition) match what the files and SKILL.md do: create book note files, store a library and schedule JSON, record quotes, schedule reviews, and generate local reports. No unexplained requests for cloud credentials, unrelated binaries, or external services.
Instruction Scope
SKILL.md instructs actions consistent with the stated purpose: creating note files, updating library.json and schedule.json, generating reports, and scheduling cron-triggered review reminders. The runtime instructions and included CLI operate only on the declared workspace paths and do not instruct reading unrelated system files, environment variables, or sending data to external endpoints.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. However, the skill bundle includes a Python script (scripts/reading_cli.py) that will be present if the skill is installed; that script performs local file I/O. No external downloads, package installs, or archive extraction are used.
Credentials
The skill requests no environment variables, no credentials, and no config paths beyond its own workspace. All data it touches is stored under the user home path (~/.qclaw/workspace/reading), which is coherent with its purpose.
Persistence & Privilege
always:false and ordinary model invocation are used. The skill does write persistent files into its own workspace, but it does not request elevated privileges, modify other skills, or declare permanent system-wide presence.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install reading-tracker - 安装完成后,直接呼叫该 Skill 的名称或使用
/reading-tracker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.0.2
**Changelog for reading-tracker v0.0.2**
- Simplified the workflow for starting a new book by removing the "Title Calibration" step.
- Updated the book note template: replaced "我的原话 / 提炼要点" sections with a streamlined "Quote" and "Reflection" format.
- Removed AI-structured highlighting in book notes to focus on user reflections.
- No new file changes detected; documentation (SKILL.md) updated for clarity and brevity.
v0.0.1
reading-tracker 1.0.0
- Initial release of a personal reading management and note-taking system.
- Track reading progress, book highlights, thoughts, and generate reports.
- Supports a progressive workflow: quote capture → weekly review → monthly synthesis.
- Spaced repetition reminders using Ebbinghaus intervals.
- Natural language triggers in both Chinese and English.
- Data organized by book, review period, and report; includes CLI tools and report generation scripts.
v1.0.5
- Refreshed documentation: SKILL.md now features clear bilingual (Chinese/English) workflow for all core features, guidance, and templates.
- Updated description to prioritize concise bilingual trigger phrases and core use cases.
- Removed outdated evaluations file; added _meta.json for better metadata management.
- No changes to functionality or commands—this release focuses on improved clarity for all users.
v1.0.4
- English documentation and workflow clarified and made more concise.
- Skill description updated for clarity and broader use of English triggers.
- Instructions and templates simplified, emphasizing core steps: start, capture, finish, review, and report.
- Data structure and report format refined for easier integration and consistent record-keeping.
- Spaced repetition and interaction rules now described in a direct, user-friendly style.
- Chinese language content and examples removed for a streamlined, English-first approach.
v1.0.3
- Added an evaluation file: `evals/evals.json`
- Expanded skill trigger description to cover any reading-related topic in both Chinese and English, enabling broader and more flexible activation.
- No changes to core workflow or data structure.
v1.0.2
- Introduced book title calibration during "Start Reading" to confirm full book names, preventing confusion from abbreviations or nicknames.
- Updated book note template: each quote now keeps the user's full original statement and adds a structured summary, both recorded together.
- Clarified workflow to actively verify and record complete book titles before tracking reading progress.
- Emphasized that the user's original quote is logged exactly as stated, alongside AI-structured key points.
- No changes to scripts or storage structure; main changes are to reading workflow and note-taking precision.
v1.0.1
- Improved documentation: all key sections now include English translations alongside Chinese text.
- Clarified core workflows, note templates, and interaction rules in both languages.
- Enhanced examples to be fully bilingual for easier understanding by a broader audience.
- Added concise English explanations to complex concepts (e.g., review algorithm, monthly report).
v1.0.0
reading-tracker v1.0.0
- Initial release of a personal reading management and note-taking system.
- Features tracking of reading progress, book excerpts, reflections, and monthly/annual reports.
- Supports spaced repetition reviews (Ebbinghaus curve) and structured output prompts.
- Provides report generation with reading stats, calendar visualization, and cross-book insights.
- Includes CLI tools for managing notes, reports, and review schedules.
- Designed for Chinese and English users; supports workflows for 30–50 books/year.
元数据
常见问题
Reading Tracker 是什么?
个人阅读管理与笔记系统。用于记录读书进度、管理书摘与思考、生成阅读报告。支持渐进式阅读法:书摘记录→每周回顾→月度串联。触发词:"开始读"、"记录书摘"、"阅读进度"、"读完"、"复习"、"本月读了什么"。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 346 次。
如何安装 Reading Tracker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install reading-tracker」即可一键安装,无需额外配置。
Reading Tracker 是免费的吗?
是的,Reading Tracker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Reading Tracker 支持哪些平台?
Reading Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Reading Tracker?
由 tt_ff117(@ttff117)开发并维护,当前版本 v0.0.2。
推荐 Skills