SKILL.md
alice-release
Alice 项目发版助手
1
元信息
技能名称、功能描述、触发词
▶
📌 设计决策：触发词的覆盖度决定了 Skill 的召回率。写得太少→用户说了该触发但没触发；写得太泛→不该触发时误触。好的触发词 = 穷举用户可能的自然表达。
2
适用条件
Agent 判断是否触发此 Skill 的决策链
▶
用户说了触发词？
→
YES
→
当前在 Alice 项目目录？
→
YES
→
触发 Skill
↓
NO
→
使用通用能力处理
同理，第二个判断节点如果为 NO（不在 Alice 目录），也走「通用能力处理」。
条件不满足时 Skill 静默退出，不会干扰正常对话。
条件不满足时 Skill 静默退出，不会干扰正常对话。
📌 设计决策：适用条件 = 防止误触的"保险"。没有适用条件，用户在任何项目里说"发版"都会触发 Alice 的发版流程——这是灾难级 Bug。
3
执行步骤
7 步管线：从 Git 检查到落地页同步
▶
检查 Git
→
运行测试
→
打包应用
→
更新版本
→
写发布日志
→
上传 COS
→
同步落地页
点击模拟 Agent 按步骤执行
📌 设计决策：步骤的顺序至关重要——"先测试再打包"还是"先打包再测试"？Skill 里的步骤顺序 = 你认为正确的 SOP 流程。Agent 会严格按顺序执行。
4
允许工具
Skill 执行期间 Agent 能使用的"武器库"
▶
可以使用
run_command
edit_file
read_file
git
web_search
禁止使用
delete_file
agent（不可启动子 Agent）
📌 设计决策：允许工具 = 安全边界。限制了 Agent 在执行这个 Skill 时能用的武器。禁止 delete_file 就是防止发版过程中误删文件；禁止子 Agent 是为了控制执行链的可预测性。
5
安全约束
不可逾越的红线——Agent 的"交通规则"
▶
不允许 force push —— 防止覆盖他人的代码提交
不允许跳过测试 —— 无论多紧急，测试不通过就不发版
失败时停止并报告，不自行重试 —— 把控制权交还人类
📌 设计决策：约束条款是 Skill 里最重要的部分。步骤写错了 Agent 只是做错事，约束缺失了 Agent 可能做"危险"的事。好的约束 = 明确的禁令 + 失败时的降级策略。