← 返回 Skills 市场
Weekly Planner
作者
Tristan Manchester
· GitHub ↗
· v1.0.0
518
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install weekly-planner
功能描述
File-based weekly planner using TOML for inbox capture, time-block scheduling, weekly review, task rollover, and optional calendar export or Google Calendar...
安全使用建议
This skill appears to do what it says: it reads and writes planner/*.toml files and provides utilities to create/rollover/validate weeks and to export .ics files. Things to consider before installing or running: 1) Scripts require Python 3.11+ (tomllib) — confirm your environment. 2) Google Calendar sync is optional and runs the external 'gog' CLI via subprocess; only enable calendar writes if you intentionally set config.calendar.write_enabled = true and run sync_week.py with --apply. Do not point planner_calendar_id at your primary calendar unless you want the planner to create/update/delete events there. 3) The SKILL metadata suggests installing gogcli from a third‑party Homebrew tap (steipete/tap) — review that tool before installing. 4) As with any workspace script, review the included Python files (they are short, local, and readable) before running; they do not contain hidden network endpoints or require secrets. 5) Run operations in a controlled workspace (or a copy) the first time to verify behavior.
功能分析
Type: OpenClaw Skill
Name: weekly-planner
Version: 1.0.0
The skill is generally well-designed and includes several safety mechanisms, such as dry-run modes and explicit write-enabled flags for calendar synchronization. The `SKILL.md` instructions are clear and do not contain obvious prompt injection attempts. However, the `scripts/init_planner.py` script is classified as suspicious due to its use of `shutil.rmtree(target_dir)` on a user-controlled `--target` path, especially when combined with the `--force` flag. While the script warns that `--force` is 'DANGEROUS', an agent could be prompted to provide a malicious target path (e.g., `--target / --force`), potentially leading to significant data loss or system disruption. This represents a high-impact vulnerability rather than intentional malice.
能力评估
Purpose & Capability
The name/description (weekly planner, TOML files, inbox capture, time-blocking, optional calendar export/sync) matches the included files and scripts (new_week.py, rollover_week.py, validate.py, export_ics.py, sync_week.py, init_planner.py). There are no unexpected required binaries or environment variables declared. The optional Google sync (via a gog CLI) is explicitly documented and therefore appropriate for the described calendar feature.
Instruction Scope
SKILL.md instructs the agent to inspect and manipulate files inside a planner/ workspace (config.toml, inbox.toml, weeks/*.toml, etc.) and to run the included Python scripts. This stays within the planner scope. Note: sync_week.py invokes the external 'gog' CLI via subprocess for Google Calendar operations — that is documented and optional, but it means calendar changes only happen if the user installs/configures gog and enables writes (config.write_enabled + --apply).
Install Mechanism
No automatic install spec is required to run the scripts (they're included), but SKILL.md metadata suggests brew formulas as convenience (python and steipete/tap/gogcli). Using a brew formula is normal; the gogcli formula comes from a third‑party tap (steipete/tap) — traceable but not a core official homebrew formula. No arbitrary downloads or archive extraction are present in the package.
Credentials
The skill declares no required environment variables, no secret inputs, and no config paths outside the planner/ folder. Calendar sync uses a local gog CLI and planner/config.toml settings (planner_calendar_id and write_enabled) rather than requiring raw tokens in env vars. That is proportionate to its purpose.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide agent settings, and only writes files under the planner/ workspace (or the .ics output path). It does not claim permanent elevated privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install weekly-planner - 安装完成后,直接呼叫该 Skill 的名称或使用
/weekly-planner触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Weekly Planner 1.0.0 – Initial release: modern, file-based weekly planning for focused week-by-week productivity.
- Inbox capture, weekly plan/schedule, and end-of-week review, all as plain TOML files.
- Fast triage: capture tasks, convert to focus outcomes, and block time with minimal friction.
- Rollover and runbook support: carry forward unfinished work and recurring weekly tasks.
- Optional safe calendar publishing: Google Calendar sync (via gogcli, dry-run/explicit apply only) or .ics export.
- Designed for minimal, human-readable files—no database required.
元数据
常见问题
Weekly Planner 是什么?
File-based weekly planner using TOML for inbox capture, time-block scheduling, weekly review, task rollover, and optional calendar export or Google Calendar... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 518 次。
如何安装 Weekly Planner?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install weekly-planner」即可一键安装,无需额外配置。
Weekly Planner 是免费的吗?
是的,Weekly Planner 完全免费(开源免费),可自由下载、安装和使用。
Weekly Planner 支持哪些平台?
Weekly Planner 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Weekly Planner?
由 Tristan Manchester(@tristanmanchester)开发并维护,当前版本 v1.0.0。
推荐 Skills