mcpField
S
summarizing-friction-logs

summarizing-friction-logs

github.com/bostonaholic开发264 次安装1 天前更新
代码仓库

关于 summarizing-friction-logs

将工作区中的 frog friction 条目汇总为只读 Markdown 仪表板的技能,帮助团队集中查看并排定障碍优先级,并区分尚未登记和已关联问题的条目。

主要功能

  1. 01收集工作区中的 friction 日志
  2. 02生成 Markdown 仪表板
  3. 03按范围整理条目摘要
  4. 04以只读方式处理日志
  5. 05区分待处理与已关联条目

适用场景

  1. 01查看多个仓库工作区中的障碍
  2. 02优先处理尚未登记的条目
  3. 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