relay-kit 0.2.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relay-kit",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Skills-first, CLI-assisted AI programming relay workflow toolkit.",
   "types": "./dist/cli.d.ts",
   "repository": {
@@ -24,8 +24,19 @@
     "CHANGELOG.md",
     "skills",
     "templates",
-    "README.md"
+    ".opencode",
+    ".claude",
+    ".codex",
+    "README.md",
+    "README.en.md"
   ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup",
+    "prepublishOnly": "pnpm build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts"
+  },
   "keywords": [
     "ai",
     "cli",
@@ -45,10 +56,5 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --test tests/*.test.ts"
-  }
-}
+  "packageManager": "pnpm@9.15.0"
+}

package/skills/relay-delegator/SKILL.md

@@ -14,8 +14,17 @@ description: 内部 skill，由 planner 自动衔接触发，将任务委派给
 2. 生成有边界的执行指令。
 3. 始终指定允许范围和禁止范围。
 4. 始终提及升级规则。
-5. 如果存在 OpenSpec，引用 proposal/design/tasks。
-6. 如果不存在 OpenSpec，使用 simple 模式。
+5. 如果存在 OpenSpec，完整引用 proposal/design/tasks/specs 内容。
+6. 如果 OpenSpec change 存在，运行 `relay openspec status --change <name> --json` 确认 artifact 状态。
+7. 如果不存在 OpenSpec，使用 simple 模式。
+
+## OpenSpec 集成
+
+当项目为 OpenSpec 模式时：
+- 将 proposal.md 的核心目标提炼到 Task 描述中。
+- 将 design.md 的关键决策注入 Allowed Scope（不要全文复制，提取约束）。
+- 将 tasks.md 的检查清单作为 Execution Steps。
+- 明确引用 OpenSpec change 名称和 schema。
 
 ## 输出格式
 
@@ -27,8 +36,10 @@ description: 内部 skill，由 planner 自动衔接触发，将任务委派给
 ## Task
 
 ## Source
+<!-- 如源自 OpenSpec，标注 change 名称和路径 -->
 
 ## Read First
+<!-- 需要预先了解的上下文文件 -->
 
 ## Allowed Scope
 
@@ -37,6 +48,7 @@ description: 内部 skill，由 planner 自动衔接触发，将任务委派给
 ## Requirements
 
 ## Escalation Rule
+同一问题尝试 2 次后仍失败，停止并生成 ASK_ADVISOR.md。
 
 ## Verification
 

package/skills/relay-planner/SKILL.md

@@ -26,6 +26,17 @@ description: 当用户运行 /relay:plan 或需要规划功能、决定 simple v
 5. 如果任务是小的 UI/文案/bugfix，simple 模式可以接受。
 6. 你可以提出多个路线图项，但同一时间只应实施一个活跃 change。
 
+## OpenSpec 集成
+
+当推荐 OpenSpec 模式时，在输出末尾提供具体的下一步指令：
+
+- 创建 change 目录：
+  ```bash
+  relay openspec new-change <name>
+  ```
+- 然后运行 `/opsx:propose <name>` 创建完整制品（proposal → design → tasks）。
+- 或者手动创建各 artifact 文件后，用 `relay start --change <name>` 生成执行任务。
+
 ## 输出格式
 
 # PLAN_REPORT
@@ -50,3 +61,4 @@ simple / openspec
 ## Human Decision Points
 
 ## 建议下一步
+<!-- 当推荐 OpenSpec 时，此处给出具体的执行命令 -->

package/skills/relay-runner/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: relay-runner
-description: 当用户运行 /relay:run 或需要执行任务时使用。自动检测读取 EXECUTOR_TASK.md 或 RESUME_PROMPT.md，以 Executor 角色执行实现。
+description: 当用户运行 /relay:run 或需要执行任务时使用。自动检测读取 EXECUTOR_TASK.md 或 RESUME_PROMPT.md，以 Executor 角色执行实现。支持任务进度追踪和自动重试。
 ---
 
 
@@ -22,12 +22,24 @@ description: 当用户运行 /relay:run 或需要执行任务时使用。自动
 
 ## 核心规则
 
-1. 小步执行。
+1. 小步执行。每次只完成一个子任务。
 2. 不要超出当前任务范围。
 3. 未经批准不要引入新依赖。
 4. 除非明确要求，不要进行大规模重构。
 5. 有意义的变更后，报告变更文件和验证步骤。
 
+## 任务进度追踪
+
+- 将 EXECUTOR_TASK.md 中的任务拆分为微步骤。
+- 每完成一个微步骤，报告进度：`[N/M] <步骤描述> ✓`
+- 如果 EXECUTOR_TASK.md 包含 OpenSpec tasks.md 内容，按 tasks.md 的 `- [ ]` 清单逐项执行。
+- 每完成一个 task，将对应行标记为 `- [x]`。
+
+## 重试与升级规则
+
+- 首次失败：分析原因，尝试替代方案。
+- 同一问题尝试 2 次后仍失败：停止，创建 `ASK_ADVISOR.md`。
+
 ## 停止并生成 ASK_ADVISOR.md
 
 以下情况停止修改代码，创建 `ASK_ADVISOR.md`：
@@ -50,3 +62,4 @@ description: 当用户运行 /relay:run 或需要执行任务时使用。自动
 - 修改的文件列表
 - 每个文件的修改原因
 - 验证结果
+- 任务进度：`[M/M]` 或 `- [x]` 完成情况