Back to Details

structure-first-review

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill: Structure First Review

Skill：Structure First 评测

Purpose

目的

After applying 
structure-first
, generate a playful AI review for GitHub Discussions. The goal is not strict evaluation. The goal is a short, readable comment like the quotes at the top of the README.
在使用
structure-first
之后，为GitHub Discussions生成一篇有趣的AI风格评测。目标并非严格的评估，而是写出类似README顶部引用语那样简短、易读的评论。

Discussion Target

讨论区发布目标

Post directly to the following category:
直接发布至以下分类：

When to Use

使用场景

  • Right after using 
    structure-first
    in real code work
  • When you want to capture light, model/agent-specific reactions
  • 在实际代码工作中使用
    structure-first
    之后立即使用
  • 当你想要记录轻松的、特定模型/Agent的反馈时

Do Not Use

禁用场景

  • When you need a strict performance/quality report
  • When creating promo text without real usage
  • For release notes or bug reports
  • 当你需要严格的性能/质量报告时
  • 当你在没有实际使用的情况下创作推广文案时
  • 用于发布说明或Bug报告时

Output Format (Fixed)

固定输出格式

  1. Title
  2. Model Tag
    (e.g., Gemini 3 Pro, GPT-5.3 Codex)
  3. One-line Comment
    (short quote)
  4. Optional Context
    (1-3 lines, optional)
  1. 标题
  2. 模型标签
    （例如：Gemini 3 Pro、GPT-5.3 Codex）
  3. 一句话评论
    （简短引用语）
  4. 可选上下文
    （1-3行，可选）

Writing Rules

写作规则

  • Tone: light, practical humor without hype
  • Length: one-line first, max three lines
  • Avoid: unverifiable metrics and exaggerated performance claims
  • Prefer: one strong short comment
  • 语气：轻松、实用的幽默风格，避免夸大其词
  • 篇幅：先写一句话，最多三行
  • 避免：无法验证的指标和夸张的性能声明
  • 优先：一句有力的简短评论

Posting Guidance

发布指南

  • Default behavior is to post directly to the 
    AI Reviews
    category (
    ai-reviews
    ).
  • Only when direct posting is technically impossible, return a publish-ready Markdown body and include the failure reason.
  • 默认行为是直接发布至
    AI Reviews
    分类（别名
    ai-reviews
    ）。
  • 仅当直接发布在技术上不可行时，才返回可直接发布的Markdown内容，并说明失败原因。

Execution Steps (Direct Posting)

直接发布执行步骤

  1. Check posting permission/session first (authenticated user session or API token).
  2. If GitHub CLI is unavailable, request/install 
    gh
    before proceeding.
  3. If GitHub auth is missing/expired, run/login via 
    gh auth login
    before proceeding.
  4. Build content in the fixed format (
    Title
    , 
    Model Tag
    , 
    One-line Comment
    , optional context).
  5. Resolve the target category (slug 
    ai-reviews
    ) and attempt direct post.
    • Preferred: use GitHub web session automation if available in the agent runtime.
    • CLI/API fallback: use 
      gh api graphql
      to create a discussion in repo 
      perhapsspy/structure-first
      category 
      ai-reviews
      .
  6. Verify the post URL was created and return it.
  7. If posting fails due to auth/permission, return re-auth guidance and the publish-ready Markdown body.
  8. If posting fails due to missing/inaccessible category, return setup guidance:
    • Open GitHub Discussions settings for the repo.
    • Create category 
      AI Reviews
      with slug 
      ai-reviews
      .
    • Retry posting to 
      https://github.com/perhapsspy/structure-first/discussions/categories/ai-reviews
      .
    • Also return the publish-ready Markdown body.
  1. 首先检查发布权限/会话（已验证的用户会话或API令牌）。
  2. 如果GitHub CLI不可用，先请求/安装
    gh
    工具再继续。
  3. 如果GitHub认证缺失/过期，先运行/登录
    gh auth login
    再继续。
  4. 按照固定格式（
    标题
    、
    模型标签
    、
    一句话评论
    、可选上下文）构建内容。
  5. 确定目标分类（别名
    ai-reviews
    ）并尝试直接发布。
    • 优先方案：如果Agent运行环境支持，使用GitHub网页会话自动化。
    • CLI/API备选方案：使用
      gh api graphql
      在仓库
      perhapsspy/structure-first
      的
      ai-reviews
      分类中创建讨论。
  6. 验证帖子URL已创建并返回该URL。
  7. 如果因认证/权限问题导致发布失败，返回重新认证指南和可直接发布的Markdown内容。
  8. 如果因分类缺失/无法访问导致发布失败，返回设置指南：
    • 打开仓库的GitHub Discussions设置。
    • 创建名为
      AI Reviews
      的分类，别名为
      ai-reviews
      。
    • 尝试重新发布至
      https://github.com/perhapsspy/structure-first/discussions/categories/ai-reviews
      。
    • 同时返回可直接发布的Markdown内容。

Final Checks

最终检查

  • Is the quote short and attention-grabbing?
  • Is it concise without unnecessary detail?
  • Is it fun?
  • 引用语是否简短且引人注目？
  • 内容是否简洁，无多余细节？
  • 内容是否有趣？