SuperAPI AI 工具集

summarize-sketch

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:把一份草图(sketch)压缩成简短、可快速浏览的计划正文叙述,先供人工审阅,再发布到工程 Slack 频道。

主要能力与流程:

  1. 前置条件:需知道草图文件位置,并持有 Linear 工单 URL 的纯文本链接;若没有链接,必须停下向用户索要,不得自行查找。
  2. 生成摘要:全程保持 agent 模式,静默读取草图,按技能内“Create summary instructions”的示例密度与规则,在 ~/.cursor/plans/ 下写入以 .plan.md 结尾的 markdown 文件。
  3. 校对:对同一文件运行 wc -w,词数须不超过 250;并核对与草图一致、符合输出契约与压缩规则,不通过则原地修改并重跑校对。通过后仅输出最终词数与“Ready for feedback!”提示。
  4. 人工审阅:等待用户确认(如 proceed、looks good)后再继续。
  5. 发送父消息:运行 python3 /ABS/path/to/summarize_sketch_slack.py parent --linear <Linear URL> --title <短标题>,将 stdout 的单行 JSON 原样作为 slack_send_message 参数传入,并读取 message_context.message_ts。
  6. 发送线程回复:运行 python3 /ABS/path/to/summarize_sketch_slack.py thread --plan <摘要文件绝对路径> --thread-ts <上一步时间戳>,同样将 stdout 的 JSON 原样传入 slack_send_message。

摘要写作要求:面向 Slack 快速浏览而非实现计划;以编号加粗小节开头,无标题行、无链接、无文件路径;多数草图用 4-6 节、8-12 条要点;顶层要点约 18-24 词,硬上限 28 词;用 debit、rollback、queue、cancel 等动词;代码标识符用反引号;仅保留影响读者心智模型的行为、失败路径与关键契约。

限制:不提供 Linear 链接则无法继续;摘要词数上限 250;发布前必须经人工确认;具体频道、脚本内部实现与依赖环境资料未提供。