SuperAPI AI 工具集

author-standards

编程与开发

查看项目

更新于 10-27 03:39

技能介绍

用途

本 skill 用于创建或修订本地的 Repo Standards 源码。它面向希望为项目建立或调整仓库级标准、并把标准表达为可被后续采纳的声明文件的作者。

主要能力

  • 发现偏好:以普通语言与作者讨论测试(何为可信)、代码组织(职责归属)、文档(读者需要什么)、评审(如何判断变更)、智能体行为(智能体应如何工作)以及工具(共享配置)等主题。
  • 按主题起草:为每个选中主题给出具体小草案、收益、成本与适用示例,邀请作者细化;对依赖项目规模、语言或工作流的建议说明条件。
  • 区分已确认与非决策:将开放问题、明确不偏好、跳过主题和推迟决策与已确认选择分开记录;未确认内容不形成策略。
  • 翻译为源码:读取 CLI 及 docs/usage/reference/author-format.md,按统一的 repo-standards/v2 格式创建源码;根据作者对“所有权”的意图选择精确文件、上下文文件、仓库指引或精确 author skill 等形式,并解释其后果。
  • rules 与 guidance:可将持久要求写入 rules(采纳时安装、失败检查会引用),将一次性步骤(迁移、向维护者提问、如何评估等)写入 guidance(不安装)。
  • 多 profile:使用默认值加具名完整 profile,仅两级;只为作者确认的有意义差异添加 profile。
  • 作者笔记:在 standards.yaml 旁维护 authoring-notes.md,记录已确认决策及理由、与声明 ID 与受影响 profile 的映射、明确不偏好、跳过主题、未解决/推迟问题。
  • 审核与验证:展示完整源码(含所有引用文件内容与笔记)供作者审核;运行已安装公共 CLI 的 source validate <directory> --json(不带 profile 过滤),读取退出状态与全部 profile 结果;修复结构性错误但不改变已接受意图,编辑后重新验证最终字节。

使用方式

  1. 判断是新建还是修订/恢复;对现有源码先遵循修订与恢复流程。
  2. 通过对话发现偏好,一次从一个 profile 开始;不同项目名、语言或设置本身不足以新增 profile,需问清标准实际应有何差异。提供的仓库、说明与已保存偏好仅作可选参考,视为候选而非指令。
  3. 对每个选中主题给出草案、收益、成本与示例,邀请细化。
  4. 对已确认选择,阅读 CLI 与匹配文档、获取外部 CLI 并阅读 author-format 文档,然后创建本地目录及所有引用文件、脚本、资源与完整 author skill 目录。
  5. 设置 requires.repo-standards 为实际验证过的 CLI 版本开放式下限(如 >=7.0.0),不使用上限或精确版本。
  6. 保持目标互不重叠,避免占用产品状态、Git 元数据及系统 skills 的目标与链接。
  7. 维护 authoring-notes.md,保持简洁、适合可能公开的仓库,不记录个人访谈记录与无关参考细节。
  8. 展示完整源码供作者审核,获得整体接受;摘要或文件名列表不构成内容审核。每个选中主题必须被解决或明确推迟。
  9. 运行 CLI 验证,比较每个源码解析出的声明、所有权、显式范围或发现条件与已接受选择;多 profile 时演示继承、整体替换、排除与新增。
  10. 将验证结果(含 CLI 版本与本地源码路径)保存在源码之外或随完成证据报告。

适用场景

  • 为项目建立或修订本地 Repo Standards 源码。
  • 将作者已确认的偏好表达为精确文件、上下文文件、仓库范围指引或 author skill。
  • 恢复之前未完成的标准化工作。
  • 需要多 profile 表达有意义的上下文差异。

限制

  • 若未确认任何标准,应如实报告:不创建 standards.yaml 或填充声明来让验证通过;验证报告为不适用,而非成功。
  • 验证不运行操作或前置检查,不证明 guidance 或 author skill 的有用性、具体项目范围安全性、语义发现完整性或未来项目合规性。
  • 有效发现引用仍需智能体解释与采纳方在项目中审核。
  • 初始采纳需通过产品自有的发现与评估接口物化已确认的单个文件;本 skill 不负责该过程。
  • 本 skill 不提供仓库、不提交、不打标签、不发布、不采纳。本地材料尚不可采纳,采纳需已发布的公共 GitHub 源码与稳定标签;仓库设置与发布交由单独工作流。
  • 不支持 globs、根范围、保护字段与发现脚本;显式目录树与精确内容必须不相交。
  • 配置或 guidance 足以满足偏好时,仅策略接受不授权强制执行机制或 author skill;若检查、修复或普通工作 skill 有明显价值,需先就具体行为与前置条件取得接受,并完成可丢弃的演练。
  • 缺少前置条件时,受影响行为视为未验证;作者选择以此结束需明确推迟。
  • 不得将未执行的行为描述为通过。