每周安排助理
v1.0.0工作日日报与周记录整理工具,自动生成工作日报,梳理计划、完成、反思;当用户需要生成工作日报、管理周记录或查看总结时使用
Security Scan
OpenClaw
Suspicious
medium confidencePurpose & Capability
技能名与描述(每日报/周报整理)与包含的脚本和参考文件一致;所需依赖仅为 python-dateutil,数据仅保存在 ./weekly-plans,本质上与声明用途相符。
Instruction Scope
SKILL.md 指示通过本地脚本对本地 JSON 文件增删改查,未请求外部凭证或网络访问——这是合适的。但文档声称“工作日下午5:00/周日晚8:00自动触发”,实际仓内无调度器或守护进程,自动触发依赖于智能体(agent)按时调用;这是一个操作假设而非内置能力。此外,文档使用的字段名(例如 'date')与脚本中计划项使用的 'assigned_date' 字段不完全一致,可能导致更新/调整日期功能不能按预期工作。
Install Mechanism
这是指令 + 本地 Python 脚本的组合,没有安装脚本或外部下载,风险较低。唯一依赖是 python-dateutil,属于合理的单一第三方库。
Credentials
技能不要求任何环境变量、凭据或配置路径,所有数据存储在相对路径 ./weekly-plans,表面上与其功能成比例。
Persistence & Privilege
没有设置 always:true,也未修改其他技能或系统配置。唯一的持久性是将 JSON 文件写入 ./weekly-plans(按文档说明),这与任务需求一致。
What to consider before installing
这项技能总体上看起来是为本地周/日报管理设计的、没有外部通信或凭据要求,但有几点你应在安装前注意并验证:
- 核心实现/文档不一致:文档和命令使用的日期字段名是 'date'(或 --date),而计划结构中的字段名为 'assigned_date',脚本内部的 update/change_date 路径会把值写入 'date' 而不是 'assigned_date',可能导致查询、统计或导出结果不准确。请在生产环境使用前测试 add/update/change/delete/undo 等操作并确认数据一致性。
- 自动触发是假设而非实现:技能描述提到每天17:00 和 周日20:00 自动生成报告,但仓内没有调度器。若你需要自动化,请确保你的 agent/主机有合适的计划任务(cron、系统调度或平台的定时触发)来调用对应命令。
- 运行和数据位置:脚本在当前工作目录下创建 ./weekly-plans 并写入文件。确保 agent 运行目录安全,或在安装前修改路径以放到可靠/受限的位置;并定期备份重要数据。
- 代码审查建议:如果你依赖此技能,建议打开并检查脚本剩余(被截断部分)以确认没有未注意到的网络调用、外部命令执行或路径/权限问题;修复字段名不匹配(将 'date' 与 'assigned_date' 对齐)或更新文档以反映实际字段。
总体上没有发现网络外泄或凭据滥用的证据,但以上实现不一致足以影响功能,因此在可信隔离环境中测试并修正后再在关键工作流中使用。Like a lobster shell, security has layers — review code before you run it.
latest
周记录整理技能
任务目标
- 本技能用于:零散记录的系统化整理,包括计划、完成、反思三项
- 能力包含:记录整理、灵活调整、按需查询、工作日报、定时总结、数据分析
- 核心价值:将日常碎片化记录按时间、项目、类别系统化梳理
- 触发条件:用户需要记录计划、完成情况、反思,生成工作日报,或查看本周进度、生成周总结时
前置准备
- 数据存储:周记录存储在
./weekly-plans/目录下(每周一个JSON文件) - 使用场景:
- 每日记录:计划、完成、反思三项高频操作
- 灵活调整:修改计划、撤销完成、调整日期
- 按需查询:今日任务、本周进度、按项目查看
- 工作日报:工作日下午5点自动生成工作日报
- 定时总结:周日晚8点自动生成完整总结
- 依赖说明:
python-dateutil>=2.8.0:日期处理和计算
操作步骤
1. 日常记录(每天)
记录计划
当用户提供计划需求时:
- 理解任务内容和优先级
- 识别任务类别(work/study/health/other)
- 智能分配到具体日期(或使用用户指定日期)
- 调用脚本保存:
python scripts/weekly_planner.py add_plan --year <年份> --week <周次> --task "<任务>" --category "<类别>" --date "<日期>" --priority "<优先级>" - 确认保存,返回任务ID和分配结果
记录完成
当用户反馈完成情况时:
- 识别完成的任务(通过任务描述或ID)
- 记录完成时间、进度、备注
- 调用脚本记录:
python scripts/weekly_planner.py add_completion --year <年份> --week <周次> --task_id <ID> --notes "<备注>" - 确认记录,更新任务状态
记录反思
当用户记录反思时:
- 理解反思内容和日期
- 调用脚本保存:
python scripts/weekly_planner.py add_reflection --year <年份> --week <周次> --date "<日期>" --content "<反思内容>" - 确认已记录
2. 灵活调整
修改计划
当用户需要调整计划时:
- 识别要修改的任务和修改内容
- 调用脚本更新:
python scripts/weekly_planner.py update_plan --year <年份> --week <周次> --task_id <ID> --field "<字段>" --value "<新值>" - 支持修改的字段:task, category, date, priority
- 确认更新完成
撤销完成
当用户需要撤销完成记录时:
- 识别要撤销的任务
- 调用脚本撤销:
python scripts/weekly_planner.py undo_completion --year <年份> --week <周次> --task_id <ID> - 确认撤销,任务状态恢复为pending
调整日期
当用户需要调整任务日期时:
- 识别任务和新日期
- 调用脚本调整:
python scripts/weekly_planner.py change_date --year <年份> --week <周次> --task_id <ID> --new_date "<日期>" - 验证新日期在周范围内
- 确认调整完成
删除计划
当用户需要删除计划时:
- 识别要删除的任务
- 调用脚本删除:
python scripts/weekly_planner.py delete_plan --year <年份> --week <周次> --task_id <ID> - 软删除标记(保留数据但标记为已删除)
- 确认删除完成
3. 按需查询
查看今日
当用户查看今日情况时:
- 确定当前日期
- 调用脚本查询:
python scripts/weekly_planner.py query_today --year <年份> --week <周次> --date "<日期>" - 智能体整理结果,按时间顺序展示:
- 今日计划任务
- 今日完成记录
- 今日反思内容
- 完成进度统计
查看本周
当用户查看本周整体情况时:
- 调用脚本查询:
python scripts/weekly_planner.py query_week --year <年份> --week <周次> - 智能体整理结果:
- 按日期分组展示所有记录
- 计划、完成、反思分别梳理
- 完成率统计
- 任务分布分析
按项目查看
当用户按类别/项目查看时:
- 识别要查询的类别
- 调用脚本查询:
python scripts/weekly_planner.py query_by_category --year <年份> --week <周次> --category "<类别>" - 展示该类别的所有计划和完成情况
4. 工作日报
自动触发(工作日下午5:00)
- 智能体检测当前时间和日期
- 如为工作日(周一至周五)下午5:00,自动触发日报流程
- 调用脚本生成日报:
python scripts/weekly_planner.py generate_daily_report --year <年份> --week <周次> --date "<日期>" - 智能体生成工作日报,包含:
- 进度统计:计划数、完成数、完成率
- 当日计划:所有计划任务及状态
- 当日完成:已完成任务及备注
- 当日反思:反思内容
- 工作小结:智能体生成的简要总结
手动触发
用户也可随时请求当日日报:
- 理解用户需求
- 调用生成日报脚本
- 智能体生成并展示日报
5. 周日总结
自动触发(周日晚8:00)
- 智能体检测当前时间
- 如为周日晚8:00,自动触发总结流程
- 调用脚本导出数据:
python scripts/weekly_planner.py export_week_report --year <年份> --week <周次> - 智能体生成完整总结,包含:
- 计划梳理:按日期、类别整理所有计划
- 完成梳理:完成的任务、未完成的任务、完成率
- 反思汇总:按时间线整理每日反思
- 数据分析:任务分布、时间管理、效率评估
- 改进建议:基于分析提出的具体建议
手动触发
用户也可随时请求周总结:
- 理解用户需求
- 调用导出脚本
- 智能体生成总结报告
资源索引
- 数据脚本:见 scripts/weekly_planner.py(用途:数据的增删改查和导出)
- 数据格式:见 references/data-format.md(何时读取:需要了解数据结构时)
- 查询模板:见 references/query-templates.md(何时读取:生成查询结果时参考)
- 日报模板:见 references/daily-report-template.md(何时读取:生成工作日报时参考)
- 周报模板:见 references/weekly-report-template.md(何时读取:生成周总结时参考)
注意事项
- 记录优先:每天的三项记录(计划、完成、反思)是核心功能
- 灵活调整:支持随时修改、撤销、调整,适应实际变化
- 系统梳理:智能体负责将零散记录按时间、项目、类别整理
- 按需查询:用户可随时查看今日、本周或特定项目的情况
- 工作日报:工作日下午5点自动触发,也可手动触发
- 定时总结:周日晚8点自动触发,也可手动触发
- 数据持久化:所有操作通过脚本完成,确保数据一致性
使用示例
示例1:每天记录三项
用户:"今天计划完成项目报告,下午写代码,晚上反思一天的工作"
执行流程:
- 识别三项记录:
- 计划:项目报告(work)、写代码(work)
- 反思:一天的工作(今天)
- 调用脚本保存每个记录
- 确认保存,返回记录ID
后续用户反馈:"项目报告完成了,写代码只完成了一半" 执行流程:
- 记录完成:项目报告完成
- 记录进度:写代码完成50%
- 更新任务状态
示例2:随时调整计划
用户:"把今天下午的写代码任务改到明天上午"
执行流程:
- 识别任务:写代码,原计划今天下午
- 调用脚本调整日期:
change_date --task_id 2 --new_date <明天日期> - 确认调整完成
示例3:查看本周进度
用户:"帮我看看这周的情况"
执行流程:
- 调用脚本查询本周数据
- 智能体整理并展示:
- 周一:计划3项,完成2项,反思...
- 周二:计划2项,完成2项,反思...
- ...
- 总体完成率:80%
示例5:工作日报
用户:"生成今日工作日报" 或系统自动触发(工作日下午5:00)
执行流程:
- 调用脚本生成日报数据
- 智能体生成工作日报:
- 进度统计:计划3项,完成2项,完成率67%
- 当日计划:项目报告(高优先级)、代码审查(中优先级)
- 当日完成:项目报告(提前完成)、代码审查(完成)
- 当日反思:效率较高,需注意休息
- 工作小结:今日工作顺利,完成了所有高优先级任务
示例6:周日晚总结
用户:"生成本周总结" 或系统自动触发(周日晚8:00)
执行流程:
- 调用脚本导出周数据
- 智能体分析并生成:
- 计划梳理:共15项计划,按类别分布...
- 完成梳理:完成12项,未完成3项...
- 反思汇总:每日反思要点...
- 数据分析:工作日完成率高于周末...
- 改进建议:建议提高周末执行力...
Comments
Loading comments...
