baijunjie 安装项目级 cron 定时任务安装器
把「定时任务写在哪、怎么装进 crontab、怎么卸载」落成项目自己的 sh 脚本，随仓库提交。
装好后改任务只动 tasks.conf，不用记 crontab 语法，也不用 crontab -e 手工编辑。
清单格式、标记区块、PATH 固化的做法都写在模板自己的注释里，本文不复述。
跨宿主约定
只执行当前宿主对应的说明入口。
模板资源先用 $PLUGIN_ROOT，为空再用 $CLAUDE_PLUGIN_ROOT；两者都为空时，先把 SKILL_DIR
设为当前已加载的这个 SKILL.md 的绝对父目录（不是项目工作目录），再按相对路径定位。执行拷贝前先确定：
if [ -n "${PLUGIN_ROOT:-}" ]; then
TEMPLATE_DIR="$PLUGIN_ROOT/skills/cron/template/cron"
elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
TEMPLATE_DIR="$CLAUDE_PLUGIN_ROOT/skills/cron/template/cron"
else
TEMPLATE_DIR="${SKILL_DIR:?先将 SKILL_DIR 设为当前 SKILL.md 的绝对父目录}/template/cron"
fi
步骤
定脚本位置：项目已有脚本目录（
scripts/、bin/、tools/等）就放进它下面的cron/， 否则用scripts/cron/。拷贝模板：
mkdir -p <脚本目录>/cron cp -n "$TEMPLATE_DIR/"* <脚本目录>/cron/ chmod +x <脚本目录>/cron/install.sh <脚本目录>/cron/uninstall.sh已存在的文件
cp -n会静默跳过，跳过了就转「已存在时」，不要当成装好了。对齐项目：
common.sh里只有两处按项目改，直接改默认值，不要靠环境变量—— 环境变量要求以后每次 install / uninstall 都带上同一组，漏一次就装到别处去了。变量 默认 什么时候要改 PROJECT_ROOT脚本目录上溯两级 脚本不在 <项目根>/<一级目录>/cron/这个深度时LOG_DIR<项目根>/logs/cron项目已有约定的日志目录 填任务清单：从用户已有的定时需求写进
tasks.conf，不要凭空编任务—— 没有明确任务就把示例保持注释状态交付。填之前确认三件事：- 命令在项目根目录下能直接跑通（脚本要先编译的，命令里指向编译产物，不是源码）；
- 跑得比调度间隔还久的任务会重叠执行，要么拉长间隔，要么让脚本自己加锁；
- 密钥之类的敏感值走项目原有的
.env/ 配置文件，不要写进tasks.conf。
忽略日志目录：
.gitignore里确认日志目录已被忽略。注册入口（项目有统一入口时才做）：
package.json加"cron:install"/"cron:uninstall"， 或Makefile加对应 target，命令就是sh <脚本目录>/cron/install.sh/uninstall.sh。挂说明：Codex 在项目根目录的
AGENTS.md、Claude Code 在CLAUDE.md里写明定时任务改tasks.conf后跑install.sh， 不要直接crontab -e——这是后来者唯一推不出来的一条，写一行就够， 格式和参数留在tasks.conf的注释里，不要复制成第二份。不要替用户执行
install.sh：它改的是用户账号的 crontab，不是仓库内容。 交付后告诉用户自己跑，或者明确征得同意再跑。用install.sh --dry-run预览生成的区块是安全的，可以直接执行。告知用户：装出去的
cron/目录要提交进版本库； crontab 是每台机器、每个账号各一份，换机器或换用户都要重跑一次install.sh； 服务器上部署了新版代码后，命令或路径有变的也要重跑。
已存在时
项目已有 crontab 安装脚本时不要直接覆盖：先读懂它现有的任务清单格式，把模板缺的能力
（标记区块隔离、PATH 固化、% 转义、子分钟偏移）补进去，任务内容原样保留。
项目现有的定时机制不是 crontab 时停下来问用户，本 skill 只装 crontab，不替他换机制。
现状与预期不符时
要写入的路径不是普通文件 / 目录时停下来问用户，不要照写。最常见的是软链：
cp 会写到它指向的地方，而 mkdir -p 在软链上仍然静默成功，表面看不出异常。