用途
skill-article 用于把当前实例中的某个技能，写成一篇可直接发布的“技能上线”文章。文章遵循安全行业的技能公告格式：先卖技能所编码的洞察，再把技能文件本身送出去。
主要能力
- 从 memory/MEMORY.md 与最近 14 天的 memory/logs/ 中挖掘真实运行记录，包括运行次数、OK/error 状态、显著结果。
- 收集技能产出的 output/ 文件、它开启的 PR 或 issue（gh pr list --search），以及 git log -- skills/<name>/ 中的上线日期与迭代历史。
- 用真实可核实的数字（如“84 verified findings”“31 runs, 0 false alarms”）作为标题；若没有真实计数，则改用机制作为标题，绝不编造数字。
- 提炼一个反直觉论点：该技能看到了默认工作流丢弃了什么。
- 收集 1-3 个具体战例，来自 memory/logs/ 与 output/，必要时匿名化但保留机制可见；若尚无运行历史，则写“how it plays out”场景并明确标注为场景。
- 按固定结构撰写文章：标题、来源说明（2 段）、论点章节、机制（2-4 段）、战例（每条 2-4 句，结尾给出泛化模式）、认知重构章节、发布引导（指向上游仓库 star）。
- 在文章末尾以 4 反引号围栏原样嵌入目标技能的 SKILL.md，不转述、不裁剪。
- 可选生成 16:9 标题横幅：仅在传入 --banner 时，通过 Higgsfield MCP 生成一张图，提示词基于论点而非功能列表，图中只允许出现技能短名或不含文字。
- 将文章写入 output/skill-articles/${today}-<skill-name>.md，顶部包含 <!-- alts --> 注释块，提供 2 组备选标题与论点标题。
- 通过 ./notify -f /tmp/skill-article-notify.md 发送通知，包含标题、一句话论点、统计是否真实、横幅 URL（若生成）以及可点击的文章链接。
- 在 memory/logs/${today}.md 的 ### skill-article 标题下记录目标技能、标题、论点对、统计来源、输出路径与横幅状态。
使用方式
调用时传入选择器：<skill-name> [--brand <handle>] [--banner]。
- <skill-name>：公告该技能，技能必须存在于 skills/<skill-name>/ 下。
- 留空：从最近 14 天的 memory/logs/ 中挑选最值得写文章的技能，优先最近上线、产出已验证输出或达到里程碑的技能；若没有符合条件的，记录 SKILL_ARTICLE_NO_TARGET，不发送通知并干净退出。
- --brand <handle>：用于外联页脚的署名/账号，默认取 soul/ 中该实例的公开身份，否则取仓库组织。
- --banner：额外通过 Higgsfield MCP 生成一张 16:9 标题横幅（消耗积分），默认关闭，空运行不消耗。
示例："aeon-update"、"rug-scan --brand @myproject --banner"。
适用场景
- 为实例中已上线、有运行记录的技能撰写发布文章。
- 需要基于真实数据而非营销话术来介绍技能价值。
- 希望文章附带可选的视觉横幅，并自动通知操作者。
限制
- 只写文章，不发布；发布由操作者决定，或由明确串联的发布技能执行。
- 横幅为可选且消耗真实 Higgsfield 积分，每次运行最多一张图，其失败不会阻塞文章。若 MCP 不可调用、认证过期或积分不足，会分别记录 HIGGS_NOT_CONNECTED、HIGGS_AUTH_STALE、HIGGS_NO_CREDITS，并继续后续步骤。
- 运行记录挖掘依赖 memory/logs/；只运行但不记录日志的技能会被视为未经证实，文章会如实说明而非猜测。
- 每次运行只处理一个技能；公告一组技能属于另一篇文章。
- 状态码：成功为 SKILL_ARTICLE_OK；${var} 为空且无可写目标为 SKILL_ARTICLE_NO_TARGET；指定技能没有 SKILL.md 为 SKILL_ARTICLE_NOT_FOUND。
- 横幅资源 URL 可能是限时签名 URL，通知中会提示操作者及时保存。
- 不得引用私有 fork 或内部账号，应泛化描述本实例并指向上游/公开仓库。