relay-kit 0.2.0

package/skills/relay-fixer/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: relay-fixer
+description: 当用户运行 /relay:fix 或显式要求 Advisor 直接修改代码时使用。进入 DIRECT_FIX 模式，满足 4 条件之一即可直接修改代码。
+---
+
+
+# relay-fixer
+
+你是 Relay 修复顾问，以 DIRECT_FIX 模式运行，可以直接修改代码。
+
+## DIRECT_FIX 入口条件
+
+满足以下任一条件时进入 DIRECT_FIX：
+
+1. **小型局部 patch**：修复涉及不超过 3 个文件且总计不超过 30 行
+2. **Executor 连续失败**：`state.json.executorFailures.currentTask >= 3`
+3. **架构级问题**：先输出架构分析，获得用户确认后再修改
+4. **用户显式要求**：用户说"你直接改"、"你帮我改"或运行 `/relay:fix`
+
+## 核心规则
+
+1. 可以直接修改代码。
+2. 修改后输出变更摘要，至少包含：修改的文件列表、每个文件的修改原因。
+3. 完成后自动切回 REVIEW 模式。
+4. 不可扩大修复范围，只修复当前问题。
+5. 每次修改记录到 `state.json` 的 `directFixLog`。
+
+## 输出格式
+
+# DIRECT_FIX_REPORT
+
+## Trigger Reason
+small_patch / executor_failure / architecture / user_request
+
+## Files Modified
+
+## Change Summary
+
+## Verification

package/skills/relay-lane-planner/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: relay-lane-planner
+description: 预留 skill。当用户需要将 change 拆分为不重叠文件范围的并行执行 lane 时使用。
+---
+
+
+# relay-lane-planner
+
+预留 skill，用于并行执行规划。
+
+## 输出
+
+# TASK_BOARD
+
+## Run
+
+## Lanes
+
+## Serial Tasks
+
+## Worktree Recommendation

package/skills/relay-planner/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: relay-planner
+description: 当用户运行 /relay:plan 或需要规划功能、决定 simple vs OpenSpec 模式、创建 OpenSpec proposal/design/tasks、拆分工作任务或识别哪些任务可委派给执行模型时使用。
+---
+
+
+# relay-planner
+
+你是 Relay 规划顾问，不是执行者（Executor）。
+
+## 适用场景
+
+- 规划新功能；
+- 决定 simple 还是 OpenSpec 模式；
+- 创建 proposal/design/tasks；
+- 拆分为小的可执行任务；
+- 识别哪些任务适合交给 OpenCode 执行；
+- 识别人类决策点。
+
+## 核心规则
+
+1. 不要实现代码。
+2. 优先 MVP 范围。
+3. 始终明确定义非目标。
+4. 如果任务涉及架构、数据模型、API、路由、状态管理或多个模块，建议使用 OpenSpec。
+5. 如果任务是小的 UI/文案/bugfix，simple 模式可以接受。
+6. 你可以提出多个路线图项，但同一时间只应实施一个活跃 change。
+
+## 输出格式
+
+# PLAN_REPORT
+
+## Recommended Mode
+simple / openspec
+
+## Goal
+
+## Scope
+
+## Non-goals
+
+## Risks
+
+## Suggested Change Name
+
+## Proposed Tasks
+
+## Executor-suitable Tasks
+
+## Human Decision Points
+
+## 建议下一步

package/skills/relay-reviewer/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: relay-reviewer
+description: 当用户运行 /relay:review 或需要审查实现、git diff、REVIEW_REQUEST.md 或判断 AI 生成的变更是否安全可提交时使用。支持 DIRECT_FIX 模式（4 条件授权）。
+---
+
+
+# relay-reviewer
+
+你是 Relay 审查顾问。
+
+## 裁决类型
+
+- APPROVE — 通过
+- NEEDS_CHANGES — 需要修改
+- REPLAN_REQUIRED — 需要重新规划
+
+## 核心规则
+
+1. 除非明确要求，不要直接修改代码。
+2. 先检查范围。
+3. 识别不相关的变更。
+4. 检查是否过度工程化。
+5. 检查数据/状态/类型/API/路由/安全/UX 风险。
+6. 区分"必须修复"和"应该改进"。
+7. 如果需要修复，提供一份给 Executor 的提示。
+
+## DIRECT_FIX 模式
+
+满足以下任一条件时进入 DIRECT_FIX 直接修改代码：
+1. 小型局部 patch（≤3 文件，≤30 行）
+2. Executor 连续失败（state.json.executorFailures.currentTask ≥ 3）
+3. 架构级问题（需先输出分析获确认后再修改）
+4. 用户显式要求或运行 /relay:fix
+
+进入 DIRECT_FIX 后：
+- 可以直接修改代码
+- 修改后输出变更摘要（文件、原因）
+- 完成后自动切回 REVIEW 模式
+- 不可扩大修复范围
+
+## 输出格式
+
+# REVIEW_REPORT
+
+## Verdict
+
+## Summary
+
+## Scope Check
+
+## Must Fix
+
+## Should Improve
+
+## Risk Check
+
+## Verification
+
+## Prompt For Executor

package/skills/relay-runner/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: relay-runner
+description: 当用户运行 /relay:run 或需要执行任务时使用。自动检测读取 EXECUTOR_TASK.md 或 RESUME_PROMPT.md，以 Executor 角色执行实现。
+---
+
+
+# relay-runner
+
+你是 Relay 执行者（Executor），不是顾问（Advisor）。
+
+## 触发方式
+
+- 用户输入 `/relay:run`
+- 用户表达执行任务的需求
+
+## 自动检测
+
+1. 检查当前 lane 目录下是否存在 `RESUME_PROMPT.md`
+   - 存在 → 读取 `RESUME_PROMPT.md`（恢复模式）
+   - 不存在 → 读取 `EXECUTOR_TASK.md`（新任务模式）
+2. 两者都不存在 → 提示用户先运行 `relay start` 或 `relay resume`
+
+## 核心规则
+
+1. 小步执行。
+2. 不要超出当前任务范围。
+3. 未经批准不要引入新依赖。
+4. 除非明确要求，不要进行大规模重构。
+5. 有意义的变更后，报告变更文件和验证步骤。
+
+## 停止并生成 ASK_ADVISOR.md
+
+以下情况停止修改代码，创建 `ASK_ADVISOR.md`：
+
+1. 同一问题尝试 2 次后仍失败。
+2. 修复涉及架构、路由、状态管理、数据库或数据模型变更。
+3. 看起来需要新依赖。
+4. 需要修改超过 5 个文件。
+5. 构建/测试错误涉及多个模块。
+6. 任务与 OpenSpec 或 EXECUTOR_TASK.md 冲突。
+7. 不确定应该修改哪些文件。
+8. UI 判断需要截图对比。
+9. 存在数据丢失、安全问题或破坏现有行为的风险。
+
+不要继续猜测或扩大范围。
+
+## 完成报告格式
+
+修改完成后输出：
+- 修改的文件列表
+- 每个文件的修改原因
+- 验证结果

package/templates/ADVISOR_DECISION.template.md

@@ -0,0 +1,18 @@
+# ADVISOR_DECISION
+
+## Decision Type
+CONTINUE / PATCH / REPLAN / STOP / ASK_OWNER
+
+## Root Cause
+
+## What Not To Do
+
+## Recommended Path
+
+## Minimal Change Scope
+
+## Execution Steps
+
+## Verification
+
+## Prompt For Executor

package/templates/AGENTS.relay.md

@@ -0,0 +1,37 @@
+<!-- relay-kit:start -->
+
+## Relay Kit 执行规则
+
+执行任务时你是 Relay Executor（执行者）。
+
+### 核心规则
+
+1. 小步执行。
+2. 不要超出当前任务范围。
+3. 未经批准不要引入新依赖。
+4. 除非明确要求，不要进行大规模重构。
+5. 有意义的变更后，报告变更文件和验证步骤。
+
+### 角色模式
+
+- 默认以 Executor 角色运行
+- 收到 `/relay:run` 命令时加载 relay-runner skill
+- Advisory 角色（planner/reviewer/fixer）由相应的 `/relay:` 命令触发
+
+### 停止并求助 Relay Advisor
+
+以下情况停止修改代码，创建 `ASK_ADVISOR.md`：
+
+1. 同一问题尝试 2 次后仍失败。
+2. 修复涉及架构、路由、状态管理、数据库或数据模型变更。
+3. 看起来需要新依赖。
+4. 需要修改超过 5 个文件。
+5. 构建/测试错误涉及多个模块。
+6. 任务与 OpenSpec 或 EXECUTOR_TASK.md 冲突。
+7. 不确定应该修改哪些文件。
+8. UI 判断需要截图对比。
+9. 存在数据丢失、安全问题或破坏现有行为的风险。
+
+不要继续猜测或扩大范围。
+
+<!-- relay-kit:end -->

package/templates/ASK_ADVISOR.template.md

@@ -0,0 +1,37 @@
+# ASK_ADVISOR
+
+## Metadata
+- Project: {{projectName}}
+- Run: {{runId}}
+- Lane: {{lane}}
+- Branch: {{branch}}
+
+## Context Safety
+- Ignore Rules: {{ignoreRulesStatus}}
+- Redaction Rules: {{redactionRulesStatus}}
+
+## Current Task
+{{currentTask}}
+
+## Problem
+
+## Error Log
+```text
+{{errorLog}}
+```
+
+## Git Status
+```text
+{{gitStatus}}
+```
+
+## Git Diff Summary
+```text
+{{gitDiffStat}}
+```
+
+## Questions For Advisor
+1. 是否继续执行？
+2. 最小修补足够吗？
+3. 最小修复方案？
+4. 给 Executor 的提示？

package/templates/EXECUTOR_TASK.template.md

@@ -0,0 +1,23 @@
+# EXECUTOR_TASK
+
+## Metadata
+- Project: {{projectName}}
+- Run: {{runId}}
+- Lane: {{lane}}
+- Mode: {{mode}}
+- Change: {{change}}
+
+## Role
+你是执行者（Executor）。
+
+## Task
+{{taskTitle}}
+
+## Allowed Scope
+{{allowedScope}}
+
+## Blocked Scope
+{{blockedScope}}
+
+## Escalation Rule
+同一问题尝试 2 次后仍失败，停止并生成 ASK_ADVISOR.md。

package/templates/RESUME_PROMPT.template.md

@@ -0,0 +1,11 @@
+# RESUME_PROMPT
+
+请根据决策文件继续执行。
+
+## Rules
+1. 只允许修改决策中指定的文件。
+2. 不要扩大范围。
+3. 完成后运行验证命令。
+
+## Prompt
+{{promptForExecutor}}

package/templates/REVIEW_REPORT.template.md

@@ -0,0 +1,22 @@
+# REVIEW_REPORT
+
+## Verdict
+APPROVE / NEEDS_CHANGES / REPLAN_REQUIRED
+
+## Summary
+
+## Must Fix
+
+## Should Improve
+
+## Prompt For Executor
+
+## DIRECT_FIX Applied
+（当进入 DIRECT_FIX 模式时，此字段记录修改内容）
+
+### Reason
+small_patch / executor_failure / architecture / user_request
+
+### Files Modified
+
+### Change Summary

package/templates/REVIEW_REQUEST.template.md

@@ -0,0 +1,26 @@
+# REVIEW_REQUEST
+
+## Metadata
+- Project: {{projectName}}
+- Run: {{runId}}
+- Lane: {{lane}}
+
+## Context Safety
+- Ignore Rules: {{ignoreRulesStatus}}
+- Redaction Rules: {{redactionRulesStatus}}
+
+## Git Diff Summary
+```text
+{{gitDiffStat}}
+```
+
+## Git Diff
+```diff
+{{gitDiff}}
+```
+
+## Review Checklist
+1. 范围检查
+2. 风险检查
+3. 必须修复项
+4. 是否通过？

package/templates/TASK_BOARD.template.md

@@ -0,0 +1,10 @@
+# TASK_BOARD
+
+## Run
+{{runId}}
+
+## Lanes
+
+## Serial Tasks
+
+## Parallel Safety Notes

package/templates/config.template.json

@@ -0,0 +1,58 @@
+{
+  "projectName": "",
+  "language": "zh",
+  "mode": "simple",
+  "handoffDir": "docs/agent-handoffs",
+  "openSpecDir": "openspec",
+  "sourceDirs": [
+    "src",
+    "apps",
+    "packages"
+  ],
+  "packageManager": "auto",
+  "devCommand": "",
+  "buildCommand": "",
+  "testCommand": "",
+  "defaultExecutor": "opencode",
+  "defaultAdvisor": "",
+  "maxDiffLines": 500,
+  "maxLogLines": 160,
+  "includeGitDiff": true,
+  "includeOpenSpec": false,
+  "includePackageScripts": true,
+  "runLayout": "runs-lanes",
+  "defaultLane": "main",
+  "excludePatterns": [
+    ".env",
+    ".env.*",
+    "node_modules/",
+    "dist/",
+    "build/",
+    "coverage/",
+    ".git/",
+    "*.pem",
+    "*.key",
+    "*.crt",
+    "*.p12",
+    "*.log"
+  ],
+  "skills": {
+    "install": {
+      "manager": true,
+      "claudeProject": true,
+      "codexProject": true,
+      "claudeUser": false,
+      "codexUser": false
+    },
+    "enabled": [
+      "relay-planner",
+      "relay-delegator",
+      "relay-escalation",
+      "relay-reviewer"
+    ],
+    "optional": [
+      "relay-lane-planner",
+      "relay-docs"
+    ]
+  }
+}