关于 summarizing-friction-logs
将工作区中的 frog friction 条目汇总为只读 Markdown 仪表板的技能,帮助团队集中查看并排定障碍优先级,并区分尚未登记和已关联问题的条目。
主要功能
- 01收集工作区中的 friction 日志
- 02生成 Markdown 仪表板
- 03按范围整理条目摘要
- 04以只读方式处理日志
- 05区分待处理与已关联条目
适用场景
- 01查看多个仓库工作区中的障碍
- 02优先处理尚未登记的条目
- 03同时浏览已关联问题和待处理报告
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bostonaholic/ skills --skill summarizing-friction-logs安装后在 Claude Code 中输入/summarizing-friction-logs确认已加载。
附带文件agents/openai.yamlscripts/collect-friction.mjs
详细介绍
汇总摩擦日志
将工作区中的所有 frog 摩擦记录汇总到一个只读仪表板中,以便在一个视图中优先处理已知摩擦。
规则
- 只读。 切勿运行
frog resolve或frog publish,切勿编辑记录,也切勿安装 frog。 pending最重要。pending记录尚未提交到其他地方,因此在此仪表板之外不可见;linked记录已有对应的问题。
收集
工作区是存放用户各个仓库的目录。将 <skill-dir> 解析为此技能的绝对目录并运行;如果用户指定了工作区,则添加 --workspace <dir>:
node "<skill-dir>/scripts/collect-friction.mjs" [--workspace <dir>]
它会输出包含渲染后的 header、table 和 footer 的 JSON,以及需要填写的 gist_slots。
- 退出码 0:构建下方的仪表板。
- 退出码 1:报告 stderr 并停止。如果提示
not in a git repository,向用户询问一次工作区,然后使用--workspace重新运行。如果提示未找到摩擦日志,说明工作区位置,并建议将此技能指向存放日志的目录。 - 退出码 2:无法读取任何日志。逐行报告 stderr 并停止。
仪表板
按以下顺序生成一个 Markdown 仪表板:
- 页眉:逐字使用
header。 - 表格:逐字使用
table。 - 详情:按顺序为每个
gist_slots项添加一条记录,并按 scope 分组,各组使用一个标题。读取槽位的path,将其正文提炼为一句摘要:说明遇到了什么阻碍,以及正文提到的建议修复方案。摘要由模型撰写,因为它们是对散文内容的总结。 - 页脚:如果
footer非空,则逐字使用。
评论
支持 Markdown