@gong-ym/ai-spec-auto 0.2.13 → 0.2.15

package/.agents/skills/common/skill-creator/scripts/quick_validate.py

@@ -1,51 +1,51 @@
-#!/usr/bin/env python3
-"""
-Quick validation wrapper for local skills.
-
-Delegates to the repository's Node-based skill-spec validator so packaging,
-registry validation, and local one-off checks stay aligned.
-"""
-
-import json
-import subprocess
-import sys
-from pathlib import Path
-
-
-def _validator_path():
-    return Path(__file__).resolve().parents[5] / "bin" / "skill-spec-validator.js"
-
-
-def validate_skill(skill_path):
-    validator = _validator_path()
-    command = ["node", str(validator), str(skill_path), "--json"]
-    result = subprocess.run(command, capture_output=True, text=True)
-
-    if result.returncode not in (0, 1):
-        message = result.stderr.strip() or result.stdout.strip() or "validator execution failed"
-        return False, message
-
-    try:
-        report = json.loads(result.stdout)
-    except json.JSONDecodeError:
-        message = result.stderr.strip() or result.stdout.strip() or "validator returned invalid JSON"
-        return False, message
-
-    if report.get("errors"):
-        return False, "; ".join(report["errors"])
-
-    warning_count = len(report.get("warnings", []))
-    if warning_count > 0:
-        return True, f"Skill is valid with {warning_count} warning(s)"
-
-    return True, "Skill is valid!"
-
-
-if __name__ == "__main__":
-    if len(sys.argv) != 2:
-        print("Usage: python quick_validate.py <skill_directory>")
-        sys.exit(1)
-
-    valid, message = validate_skill(sys.argv[1])
-    print(message)
-    sys.exit(0 if valid else 1)
+#!/usr/bin/env python3
+"""
+Quick validation wrapper for local skills.
+
+Delegates to the repository's Node-based skill-spec validator so packaging,
+registry validation, and local one-off checks stay aligned.
+"""
+
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _validator_path():
+    return Path(__file__).resolve().parents[5] / "bin" / "skill-spec-validator.js"
+
+
+def validate_skill(skill_path):
+    validator = _validator_path()
+    command = ["node", str(validator), str(skill_path), "--json"]
+    result = subprocess.run(command, capture_output=True, text=True)
+
+    if result.returncode not in (0, 1):
+        message = result.stderr.strip() or result.stdout.strip() or "validator execution failed"
+        return False, message
+
+    try:
+        report = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        message = result.stderr.strip() or result.stdout.strip() or "validator returned invalid JSON"
+        return False, message
+
+    if report.get("errors"):
+        return False, "; ".join(report["errors"])
+
+    warning_count = len(report.get("warnings", []))
+    if warning_count > 0:
+        return True, f"Skill is valid with {warning_count} warning(s)"
+
+    return True, "Skill is valid!"
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)

package/.agents/skills/common/skill-optimizer/SKILL.md

@@ -1,102 +1,102 @@
----
-name: skill-optimizer
-description: 优化和重构现有 skill 的触发描述、工作流、确认门槛和资源组织方式。当用户说“优化 skill”“检查 skill 质量”“改进某个 skill”“重构技能说明”时使用。默认先审查，再出计划，确认后再改。
----
-
-# Skill 优化器
-
-## 定位
-
-本技能用于优化已有 skill，不负责从零创建 skill。
-
-分工如下：
-
-- `skill-creator`：从无到有创建 skill
-- `skill-optimizer`：审查、收口、重构现有 skill
-
-## 工作原则
-
-- 先审查，再计划，再修改
-- 未确认前不改目标 skill
-- 优先解决触发失败、确认缺失、流程不可执行的问题
-- 只读取目标 skill 直接相关的 `SKILL.md / references / scripts / assets`
-
-默认参考：
-
-- [审查清单](references/review-checklist.md)
-- [设计模式判断](references/design-patterns.md)
-
-## 工作流
-
-复制并跟踪这份清单：
-
-```text
-优化进度：
-- [ ] 1. 确定范围
-- [ ] 2. 审查现状
-- [ ] 3. 输出优化计划
-- [ ] 4. 用户确认
-- [ ] 5. 实施与校验
-```
-
-### 1. 确定范围
-
-- 先确认目标 skill
-- 若用户只给方向，例如“只改 description”，则只做局部审查
-- 若用户只说“优化这个 skill”，先给完整审查结论
-
-### 2. 审查现状
-
-重点检查：
-
-- `description` 是否同时说明“做什么”和“何时用”
-- SKILL.md 是否清晰、可执行、不过胖
-- 是否缺少确认门槛、gotchas、模板、脚本或 references
-- 是否把重型细节塞进正文而不是拆到 references
-- 输出格式是否稳定，能否交给另一个 agent 执行
-
-### 3. 输出优化计划
-
-必须先给：
-
-1. 审查结论
-2. 分优先级的优化计划
-
-不要直接改文件。
-
-### 4. 用户确认
-
-- 明确等待确认
-- 若用户只同意部分变更，只实施已确认范围
-
-### 5. 实施与校验
-
-至少校验：
-
-- frontmatter 合法
-- `name`、目录名、触发语义一致
-- `description` 能独立触发
-- 主体更短、更清晰、更可执行
-
-## 输出模板
-
-```md
-# Skill 审查结论
-
-## 高优先级
-- ...
-
-## 中优先级
-- ...
-
-# 优化计划
-1. 修改 ...
-2. 新增 ...
-3. 删除或下沉 ...
-```
-
-## 禁止事项
-
-- 未确认前直接改目标 skill
-- 为了“完整”把无关 reference 全部读进上下文
-- 顺手扩大范围，把局部优化升级成整套重构
+---
+name: skill-optimizer
+description: 优化和重构现有 skill 的触发描述、工作流、确认门槛和资源组织方式。当用户说“优化 skill”“检查 skill 质量”“改进某个 skill”“重构技能说明”时使用。默认先审查，再出计划，确认后再改。
+---
+
+# Skill 优化器
+
+## 定位
+
+本技能用于优化已有 skill，不负责从零创建 skill。
+
+分工如下：
+
+- `skill-creator`：从无到有创建 skill
+- `skill-optimizer`：审查、收口、重构现有 skill
+
+## 工作原则
+
+- 先审查，再计划，再修改
+- 未确认前不改目标 skill
+- 优先解决触发失败、确认缺失、流程不可执行的问题
+- 只读取目标 skill 直接相关的 `SKILL.md / references / scripts / assets`
+
+默认参考：
+
+- [审查清单](references/review-checklist.md)
+- [设计模式判断](references/design-patterns.md)
+
+## 工作流
+
+复制并跟踪这份清单：
+
+```text
+优化进度：
+- [ ] 1. 确定范围
+- [ ] 2. 审查现状
+- [ ] 3. 输出优化计划
+- [ ] 4. 用户确认
+- [ ] 5. 实施与校验
+```
+
+### 1. 确定范围
+
+- 先确认目标 skill
+- 若用户只给方向，例如“只改 description”，则只做局部审查
+- 若用户只说“优化这个 skill”，先给完整审查结论
+
+### 2. 审查现状
+
+重点检查：
+
+- `description` 是否同时说明“做什么”和“何时用”
+- SKILL.md 是否清晰、可执行、不过胖
+- 是否缺少确认门槛、gotchas、模板、脚本或 references
+- 是否把重型细节塞进正文而不是拆到 references
+- 输出格式是否稳定，能否交给另一个 agent 执行
+
+### 3. 输出优化计划
+
+必须先给：
+
+1. 审查结论
+2. 分优先级的优化计划
+
+不要直接改文件。
+
+### 4. 用户确认
+
+- 明确等待确认
+- 若用户只同意部分变更，只实施已确认范围
+
+### 5. 实施与校验
+
+至少校验：
+
+- frontmatter 合法
+- `name`、目录名、触发语义一致
+- `description` 能独立触发
+- 主体更短、更清晰、更可执行
+
+## 输出模板
+
+```md
+# Skill 审查结论
+
+## 高优先级
+- ...
+
+## 中优先级
+- ...
+
+# 优化计划
+1. 修改 ...
+2. 新增 ...
+3. 删除或下沉 ...
+```
+
+## 禁止事项
+
+- 未确认前直接改目标 skill
+- 为了“完整”把无关 reference 全部读进上下文
+- 顺手扩大范围，把局部优化升级成整套重构

package/.agents/skills/common/skill-optimizer/evals/evals.json

@@ -1,16 +1,16 @@
-{
-  "skill_name": "skill-optimizer",
-  "evals": [
-    {
-      "id": "optimizer-output-1",
-      "prompt": "审查一个现有 skill，指出 description、workflow 和 resources 的问题，并给出分优先级优化计划。",
-      "files": [],
-      "expected_output": "输出应先给审查结论，再给按优先级排序的优化计划，不直接改文件。",
-      "assertions": [
-        "先审查后计划",
-        "指出触发、结构和资源组织问题",
-        "保留等待用户确认的门槛"
-      ]
-    }
-  ]
-}
+{
+  "skill_name": "skill-optimizer",
+  "evals": [
+    {
+      "id": "optimizer-output-1",
+      "prompt": "审查一个现有 skill，指出 description、workflow 和 resources 的问题，并给出分优先级优化计划。",
+      "files": [],
+      "expected_output": "输出应先给审查结论，再给按优先级排序的优化计划，不直接改文件。",
+      "assertions": [
+        "先审查后计划",
+        "指出触发、结构和资源组织问题",
+        "保留等待用户确认的门槛"
+      ]
+    }
+  ]
+}

package/.agents/skills/common/skill-optimizer/evals/train_queries.json

@@ -1,18 +1,18 @@
-[
-  {
-    "query": "优化这个 skill 的触发描述和 references 结构",
-    "should_trigger": true
-  },
-  {
-    "query": "检查一下这个 skill 为什么老是误触发",
-    "should_trigger": true
-  },
-  {
-    "query": "帮我新建一个 skill",
-    "should_trigger": false
-  },
-  {
-    "query": "给现有 skill 加一个脚本并重构正文",
-    "should_trigger": true
-  }
-]
+[
+  {
+    "query": "优化这个 skill 的触发描述和 references 结构",
+    "should_trigger": true
+  },
+  {
+    "query": "检查一下这个 skill 为什么老是误触发",
+    "should_trigger": true
+  },
+  {
+    "query": "帮我新建一个 skill",
+    "should_trigger": false
+  },
+  {
+    "query": "给现有 skill 加一个脚本并重构正文",
+    "should_trigger": true
+  }
+]

package/.agents/skills/common/skill-optimizer/evals/validation_queries.json

@@ -1,18 +1,18 @@
-[
-  {
-    "query": "重写 skill 的 workflow 和 gotchas",
-    "should_trigger": true
-  },
-  {
-    "query": "审查这个 skill 的 frontmatter 是否合规",
-    "should_trigger": true
-  },
-  {
-    "query": "从零搭一个新 skill 包",
-    "should_trigger": false
-  },
-  {
-    "query": "给我列出有哪些可安装的开源 skills",
-    "should_trigger": false
-  }
-]
+[
+  {
+    "query": "重写 skill 的 workflow 和 gotchas",
+    "should_trigger": true
+  },
+  {
+    "query": "审查这个 skill 的 frontmatter 是否合规",
+    "should_trigger": true
+  },
+  {
+    "query": "从零搭一个新 skill 包",
+    "should_trigger": false
+  },
+  {
+    "query": "给我列出有哪些可安装的开源 skills",
+    "should_trigger": false
+  }
+]

package/.agents/skills/common/skill-optimizer/references/design-patterns.md

@@ -1,26 +1,26 @@
-# Skill 设计模式判断
-
-优化现有 skill 时，先判断它主要属于哪类模式：
-
-- `Tool Wrapper`
-  - 主要职责是稳定调用某个工具或脚本
-- `Generator`
-  - 主要职责是产出文档、代码骨架或模板
-- `Reviewer`
-  - 主要职责是检查、评审、给出问题项
-- `Inversion`
-  - 主要职责是先计划、先确认，再进入实施
-- `Pipeline`
-  - 主要职责是组织多个顺序步骤
-
-判断标准：
-
-- 如果主要价值在“发现问题”，优先按 `Reviewer`
-- 如果主要价值在“先出方案再动手”，优先按 `Inversion`
-- 如果主要价值在“稳定生成产物”，优先按 `Generator`
-
-常见问题：
-
-- 一个 skill 同时承担 Review、Plan、Implement，导致门槛模糊
-- 明明是 `Reviewer`，却把大量生成模板塞进正文
-- 明明是 `Pipeline`，却没有明确的停止条件和确认点
+# Skill 设计模式判断
+
+优化现有 skill 时，先判断它主要属于哪类模式：
+
+- `Tool Wrapper`
+  - 主要职责是稳定调用某个工具或脚本
+- `Generator`
+  - 主要职责是产出文档、代码骨架或模板
+- `Reviewer`
+  - 主要职责是检查、评审、给出问题项
+- `Inversion`
+  - 主要职责是先计划、先确认，再进入实施
+- `Pipeline`
+  - 主要职责是组织多个顺序步骤
+
+判断标准：
+
+- 如果主要价值在“发现问题”，优先按 `Reviewer`
+- 如果主要价值在“先出方案再动手”，优先按 `Inversion`
+- 如果主要价值在“稳定生成产物”，优先按 `Generator`
+
+常见问题：
+
+- 一个 skill 同时承担 Review、Plan、Implement，导致门槛模糊
+- 明明是 `Reviewer`，却把大量生成模板塞进正文
+- 明明是 `Pipeline`，却没有明确的停止条件和确认点

package/.agents/skills/common/skill-optimizer/references/review-checklist.md

@@ -1,22 +1,22 @@
-# Skill 审查清单
-
-按以下顺序检查：
-
-1. 触发是否清晰
-2. 工作流是否可执行
-3. 是否存在必须确认却没有卡住的步骤
-4. 正文是否过胖，是否应拆到 `references/` 或 `scripts/`
-5. 输出是否稳定、便于交接
-6. 是否有明显的默认行为越权
-
-优先修复：
-
-- 触发不准
-- 工作流断裂
-- 缺少确认门槛
-
-其次修复：
-
-- 结构臃肿
-- references / scripts / assets 组织混乱
-- 输出格式不稳定
+# Skill 审查清单
+
+按以下顺序检查：
+
+1. 触发是否清晰
+2. 工作流是否可执行
+3. 是否存在必须确认却没有卡住的步骤
+4. 正文是否过胖，是否应拆到 `references/` 或 `scripts/`
+5. 输出是否稳定、便于交接
+6. 是否有明显的默认行为越权
+
+优先修复：
+
+- 触发不准
+- 工作流断裂
+- 缺少确认门槛
+
+其次修复：
+
+- 结构臃肿
+- references / scripts / assets 组织混乱
+- 输出格式不稳定