技能上游公关

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

编辑前同步仓库(强制)

在对克隆的分叉进行任何修改之前,请从分叉的跟踪分支中提取最新内容:如果工作树脏:存储、同步、弹出。如果origin丢失或发生冲突:停止并询问用户。一个陈旧的叉子,对昨天的树进行 PR 比没有 PR 更糟糕。

何时使用

用户将 GitHub URL 共享到公共技能存储库,并要求“改进”、“升级”或“做出贡献” 用户说“针对该技能打开 PR”或“建议上游改进” 目标技能在 asm eval 上的得分低于 85/8,并且用户希望上游作者受益 不要触发以下情况:编辑没有上游的本地技能、创作全新技能、发布到 ASM 注册表或批量改进多项技能一次性回购。一项技能→一项公关。

先决条件

在克隆任何东西之前验证每一个。如果有任何失败,请停止并告诉用户。 asm 在 PATH 上 (command -v asm) gh 在 PATH 上并经过身份验证 (gh auth status) git 在 PATH 网络访问 GitHub

输入

用户提供技能的 GitHub 参考。接受以下任意一项: https://github.com/owner/repo https://github.com/owner/repo/tree/<branch>/<path/to/skill> github:owner/repo[#ref][:path] 标准化为 owner、repo、可选 ref、可选 path。如果未给出 path 并且存储库有多个 SKILL.md 文件,请询问用户是哪一个。

工作流程

按顺序执行阶段。不要跳过或重新排序。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@luongnv89 · MIT
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
阶段 0 — 分叉和克隆

`gh repo fork --clone --remote`在您的帐户下创建分叉,将其克隆到本地,将`origin`设置为您的分叉,将`upstream`设置为原始存储库。在继续之前先用`git remote -v` 进行验证。创建一个专门的分支来进行改进:

02
第 1 阶段 — 找到目标 SKILL.md

如果用户给出了`path`,请使用它。否则:如果有多个匹配且没有给出`path`,则列出候选者并要求用户选择。永远不要猜测——错误的公关比延迟的公关更糟糕。将 `SKILL_PATH` 设置为包含所选 SKILL.md 的目录(不是文件本身) - `asm eval` 采用一个目录。

03
第 2 阶段 — 委托给技能自动改进者

该技能不会重新实现改进循环。按照`skills/skill-auto-improver/SKILL.md`中的工作流程,以`$SKILL_PATH`为目标:该技能的第0阶段:捕获`.asm-improver/baseline.json`第1阶段:`asm eval --fix`第2-4阶段:85/8楼层的逐类别循环第5阶段:`.asm-improver/report.md`

04
第 3 阶段 — PR 的收获指标

读取自动改进器生成的两个文件: `.asm-improver/baseline.json` — 之前的快照 最新的 `.asm-improver/iter-N.json` — 后的快照 两者的提取:`overallScore`、`grade`

05
第四阶段——建立公关机构

阅读`references/pr-template.md`并填写。该模板强调友好、建议式的语气。关键部分: 发生了什么变化 - 一句话摘要 之前/之后指标 - 包含总体分数、成绩和所有 7 个类别的表格 触及的文件 - 列出`$SKILL_PATH` 下的每个修改路径 进行的迭代 - 来自自动改进循环的 N 次(共 8 次)

06
第五阶段——最后一英里确认(强制性)

在别人的仓库上创建 PR 是公开的并且很难逆转。在推送任何内容之前,请向用户显示: PR 标题 完整的 PR 正文(呈现的降价) 确切的差异 (`git diff upstream/<default-branch>`) 您将要运行的命令

07
第 6 阶段 — 推送并打开 PR

批准后:切勿推送至`upstream`。切勿使用 `--no-verify` 或其他 hook-skip 标志。如果`gh pr create`失败,停止并报告——不要循环重试。打印`gh pr create`返回的PR URL,以便用户可以打开它。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。