@trench-craft/sds 1.0.0

package/skills/core/ecc-agents-md-router/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: ecc-agents-md-router
+description: "Parse AGENTS.md / CLAUDE.md workflow routing rules and route tasks to the correct SDS workflow phase. Auto-loads at session start."
+---
+
+# ecc:agents-md-router — AGENTS.md 工作流路由
+
+解析项目中 AGENTS.md 或 CLAUDE.md 定义的工作流路由规则，将任务路由到正确的 SDS 工作流阶段。
+
+## 重要：不主动拦截用户消息
+
+此技能为基础设施，**在后台运行**，不主动响应任何用户消息。
+用户消息由 AI 根据内容判断是否需要路由，此技能仅提供路由表供参考。
+
+## 用途
+
+每次会话开始时自动加载。根据 AGENTS.md/CLAUDE.md 中的路由配置，决定新任务应该走哪条工作流路径。
+
+## 输入
+
+- `AGENTS.md`（opencode）或 `CLAUDE.md`（claudecode）：项目级工作流配置文件
+
+## 输出
+
+- `workflow_routes`：解析后的路由规则
+
+## 路由逻辑
+
+### 1. 配置读取
+
+读取 AGENTS.md/CLAUDE.md 中 `<!-- trench-craft:begin -->` 和 `<!-- trench-craft:end -->` 之间的配置。
+
+### 2. 路由示例
+
+配置文件中的阶段定义决定了任务的路由：
+
+```markdown
+<!-- trench-craft:begin -->
+## 阶段路由
+- Phase 0: existing-code-caveman + opsx:explore
+- Phase 1: brainstorming
+- Phase 2: opsx:propose
+- Phase 3: writing-plans
+- Phase 4: opsx:apply
+- Phase 5: opsx:verify
+- Phase 6: opsx:archive
+<!-- trench-craft:end -->
+```
+
+### 3. 任务路由
+
+当接收到新任务时，根据任务内容判断阶段：
+
+| 任务类型 | 路由到 | 阶段 |
+|----------|--------|------|
+| **简单对话、问候、提问** | **不路由 — 直接回答** | **—** |
+| **项目为空时的新功能开发** | **跳过 Phase 0，直接 brainstorming** | **Phase 1** |
+| 探索代码库、了解项目 | `existing-code-caveman` / `opsx:explore` | Phase 0 |
+| 实现新功能、创建变更 | `brainstorming` | Phase 1 |
+| 设计方案、技术决策 | `opsx:propose` | Phase 2 |
+| 编写实现计划 | `writing-plans` | Phase 3 |
+| 执行代码变更 | `opsx:apply` | Phase 4 |
+| 验证代码质量 | `opsx:verify` | Phase 5 |
+| 归档已完成变更 | `opsx:archive` | Phase 6 |
+
+**第一行最重要：** 问候、闲聊、简单知识问答 — 不路由任何技能，直接让大模型回答。
+
+### 4. 判断原则
+
+路由与否的核心判断标准：
+
+- **触发技能** — 用户请求涉及编码、设计、变更、规划等开发活动
+- **不触发** — 仅限对话、问候、概念解释、简单问答、非开发话题
+
+### 4. 多模型路由（可选）
+
+如果配置了 multi-model，根据复杂度选择模型：
+
+```
+复杂度 ≤ 0.3 → quick（快速模型）
+复杂度 ≤ 0.7 → deep（标准模型）
+复杂度 > 0.7 → ultrabrain（强模型）
+UI 任务     → visual-engineering
+```
+
+## 要素
+
+- **自动加载** — 每次会话启动时执行
+- **无人工干预** — 路由决策完全自动
+- **优雅降级** — 如果 AGENTS.md 不存在，使用默认路由

package/skills/core/ecc-agents-md-router/skill.yaml

@@ -0,0 +1,12 @@
+id: "ecc:agents-md-router"
+version: "2.0.0"
+name: "agents-md-router"
+description: "解析 AGENTS.md / CLAUDE.md 中的工作流路由规则"
+category: "core"
+phase: "always"
+source: "everything-claude-code"
+dependencies: []
+inputs: ["AGENTS.md"]
+outputs: ["workflow_routes"]
+size: "small"
+cache_ttl: "30d"

package/skills/core/ecc-context-injector/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: ecc-context-injector
+description: "Inject spec context from openspec/changes/<name>/ into subagent prompts. Ensures subagents have complete context for implementation."
+---
+
+# ecc:context-injector — 规格上下文注入
+
+将在调度子代理时，将规格文档内容注入子代理的 prompt，确保子代理拥有完整的上下文信息，无需自行读取文件。
+
+## 重要：不主动拦截用户消息
+
+此技能为基础设施，**仅在调度子代理时自动触发**，不主动响应任何用户消息。
+日常对话中不产生任何作用。
+
+## 用途
+
+每次调度子代理时自动触发。从 `openspec/changes/<name>/` 读取相关工件并注入到子代理 prompt 中。
+
+## 输入
+
+- `openspec/changes/<name>/` 目录下的工件
+
+## 输出
+
+- `injected_prompt`：注入了规格上下文的子代理 prompt
+
+## 注入内容
+
+根据子代理的任务类型，注入不同的上下文：
+
+| 任务类型 | 注入内容 | 来源 |
+|----------|----------|------|
+| 实现任务 | specs.md + tasks.md 任务描述 + design.md 相关设计 | Subagent Development |
+| 代码审查 | specs.md 验收标准 + design.md 设计决策 | Spec Reviewer |
+| 质量审查 | specs.md + project coding standards | Code Quality Reviewer |
+
+## 注入格式
+
+```markdown
+## 规格上下文（自动注入）
+
+### 项目
+- 名称: <name>
+
+### 规格
+<specs.md 中与当前任务相关的内容>
+
+### 设计决策（相关部分）
+<design.md 中与当前任务相关的技术决策>
+
+### 任务描述
+<tasks.md 中当前任务的完整描述>
+
+### 验收标准
+<specs.md 中定义的验收标准>
+```
+
+## 上下文大小管理
+
+- 注入内容限制在子代理可用 token 的 30% 以内
+- 优先注入与当前任务直接相关的内容
+- 超出限制时截断优先级：验收标准 > 任务描述 > 设计决策 > 规格
+- 截断处标注 `[上下文已截断，完整内容请参考 openspec/changes/<name>/speces.md]`
+
+## 要点
+
+- **自动注入** — 调度子代理时自动执行，无需手动操作
+- **精准裁剪** — 只注入与当前任务相关的部分，避免 token 浪费
+- **优先级保留** — 关键信息（验收标准）优先注入

package/skills/core/ecc-context-injector/skill.yaml

@@ -0,0 +1,12 @@
+id: "ecc:context-injector"
+version: "2.0.0"
+name: "context-injector"
+description: "将规格文档内容注入子代理 prompt"
+category: "core"
+phase: "always"
+source: "everything-claude-code"
+dependencies: ["claude-code:subagent"]
+inputs: ["specs/*.md"]
+outputs: ["injected_prompt"]
+size: "small"
+cache_ttl: "30d"

package/skills/core/existing-code-caveman/SKILL.md

@@ -0,0 +1,340 @@
+---
+name: existing-code-caveman
+description: "项目认知中枢。通过结构索引（CodeGraph）+ 语义增强（Understand Anything）生成项目的完整认知图谱，并输出为 AI 助手引导文件（CLAUDE.md / AGENTS.md）。"
+version: 3.0.0
+---
+
+# Existing Code Caveman — Project Cognition Hub
+
+你是一名代码库考古学家，现在升级为**项目认知中枢**。当需要了解现有代码库、CLAUDE.md/AGENTS.md 缺失或过时、或在陌生代码库上开始新功能时，遵循以下四级流水线。
+
+## 触发条件
+
+- 项目首次初始化
+- 代码库发生重大变更（用户主动触发或 Git Hook 检测）
+- 子代理需要深入理解陌生模块时
+- CLAUDE.md/AGENTS.md 不存在或过时
+- **项目非空**（存在源码文件）
+
+**空项目处理**：检测到项目为空 → 跳过此技能，直接进入 Phase 1 brainstorming。
+通知用户："项目为空，跳过代码探索，直接进行需求分析。"
+
+## 依赖
+
+- **工具**: `sds graph` CLI（内置于 @trench-craft/sds）
+- **可选服务**: CodeGraph 引擎（本地 Tree-sitter）
+- **可选服务**: Understand Anything LLM 流水线
+  - 模式 1：CLI 增强（需设置 `OPENAI_API_KEY` 或 `ANTHROPIC_API_KEY`）
+  - 模式 2：AI 助手增强（推荐，使用 AI 助手自身的模型能力，无需 API Key）
+
+## 输入
+
+- 项目源码树
+- `.sds/graph.config.yaml`（如存在则复用，否则自动生成）
+
+## 输出
+
+- `.sds/codegraph.db` — 结构化代码图谱（SQLite）
+- `.sds/semantic-graph.json` — 语义增强图谱（JSON）
+- `.claude/CLAUDE.md` 或 `.opencode/AGENTS.md` — AI 助手引导文件
+- `.sds/cognition-report.json` — 认知覆盖率报告
+
+---
+
+## Phase 1: 结构感知（Structure Indexing）
+
+**目标**: 在 5 秒内建立项目骨架认知，零 LLM Token 消耗。
+
+**自动执行规则（强制）**：
+- 本技能会自动执行所有必要的 CLI 命令，用户无需手动执行
+- 使用 `bash` 工具执行命令，使用 `workdir` 参数指定工作目录
+- 每个命令执行后检查输出，确保成功完成
+
+### 步骤
+
+1. **初始化图谱配置**
+   - 检查 `.sds/graph.config.yaml` 是否存在
+   - 不存在 → 自动执行 `sds graph init`
+   - 存在 → 读取配置，复用现有设置
+
+2. **执行结构索引**
+   - 检查 `.sds/codegraph.db` 是否存在且未过期（< 24h）
+   - 存在且新鲜 → 跳至步骤 3
+   - 不存在或过期 → 自动执行 `sds graph index --incremental --verbose`
+   - 索引完成后，输出统计信息
+
+3. **导出引导文件（自动检测平台）**
+   - 检测当前平台：
+     - 存在 `.opencode/` 目录 → OpenCode 平台
+     - 存在 `CLAUDE.md` 或 `.claude/` 目录 → Claude Code 平台
+     - 两者都存在 → 同时生成两种格式
+   - OpenCode: 自动执行 `sds graph export --format agents-md`
+   - Claude Code: 自动执行 `sds graph export --format claude-md`
+
+4. **读取结构元数据**
+   - 自动执行 `sds graph status` 获取索引状态
+   - 自动执行 `sds graph query --template entry-points` 获取入口文件
+   - 自动执行 `sds graph query --template circular-deps` 检查循环依赖
+   - 记录：文件总数、语言分布、模块边界、入口文件列表、核心枢纽模块
+
+5. **传统探索（补充）**
+   - 现有文档：README.md、CONTRIBUTING.md、ARCHITECTURE.md、docs/
+   - 技术栈检测：package.json、pyproject.toml、go.mod、Cargo.toml
+   - 构建与部署：Dockerfile、docker-compose.yml、.github/workflows/
+   - Git 上下文：`git log --oneline -20`、`git branch -a`
+
+6. **生成结构摘要**
+   - 写入临时上下文，供后续阶段使用
+   - 包含：项目概览、技术栈清单、架构图（文本描述）、关键文件列表、已知约束
+
+---
+
+## Phase 2: 语义增强（Semantic Enhancement）
+
+**目标**: 对关键模块生成业务语义解释，按需触发，可控成本。
+
+### 语义增强模式
+
+支持两种模式：
+
+**模式 1：CLI 增强（需要 API Key）**
+- 设置环境变量 `OPENAI_API_KEY` 或 `ANTHROPIC_API_KEY`
+- 执行 `sds graph enhance`
+
+**模式 2：AI 助手增强（推荐，无需 API Key）**
+- 使用 AI 助手自身的模型能力进行语义分析
+- 读取 `sds graph query` 输出，由 AI 助手生成语义摘要
+- 将结果写入 `.sds/semantic-graph.json`
+
+### 触发条件（满足任一即执行）
+
+- `graph.config.yaml` 中 `enhance.enabled: true`
+- 或 `enhance.enabled: auto` 且满足：
+  - 项目文件数 < 500（控制成本）
+  - 上次语义增强距今 > 7 天
+
+### 步骤
+
+1. **检查触发条件**
+   - 读取 `.sds/graph.config.yaml` 中的 `enhance.enabled` 配置
+   - 如果为 `false` → 跳过此阶段，直接进入 Phase 3
+   - 如果为 `true` 或 `auto` → 继续执行
+
+2. **选择增强模式**
+   - 检查环境变量 `OPENAI_API_KEY` 或 `ANTHROPIC_API_KEY` 是否存在
+   - 存在 → 使用模式 1（CLI 增强）
+   - 不存在 → 使用模式 2（AI 助手增强）
+
+3. **模式 1：CLI 增强**
+   - 执行 `sds graph enhance --dry-run` 预览采样文件
+   - 向用户报告预览结果："将分析 N 个核心文件，预计消耗 Xk Token，是否继续？"
+   - 等待用户确认后执行 `sds graph enhance`
+
+4. **模式 2：AI 助手增强**
+   - 执行 `sds graph query --sql "SELECT path, name, type FROM symbols LIMIT 100"` 获取代码结构
+   - 执行 `sds graph query --template entry-points` 获取入口文件
+   - AI 助手根据代码结构生成语义摘要：
+     - 项目摘要（description, techStack, architecturePattern）
+     - 文件级语义（summary, responsibility, inputs, outputs）
+     - 模块级语义（description, files, publicApi）
+   - 将结果写入 `.sds/semantic-graph.json`
+
+5. **读取语义图谱**
+   - 读取生成的 `.sds/semantic-graph.json`
+   - 提取：项目摘要、模块描述、数据流、学习路径
+
+### 成本控制策略
+
+- 自动采样仅覆盖核心模块（入口 + 枢纽 + 领域代表）
+- 单次 enhance 默认 Token 预算 100k，超预算时自动降级为 `lite` 模式
+- 支持 `--files` 参数指定仅分析用户关心的模块
+
+### 查询示例
+
+```bash
+# 查询项目概览
+sds graph query --sql "SELECT * FROM files LIMIT 10"
+
+# 查询所有函数
+sds graph query --sql "SELECT name, type FROM symbols WHERE type = 'function' LIMIT 20"
+
+# 查询调用关系
+sds graph query --sql "
+  SELECT f1.path as caller_file, s1.name as caller, f2.path as callee_file, s2.name as callee
+  FROM call_graph cg
+  JOIN files f1 ON cg.caller_file_id = f1.id
+  JOIN symbols s1 ON cg.caller_symbol_id = s1.id
+  JOIN files f2 ON cg.callee_file_id = f2.id
+  JOIN symbols s2 ON cg.callee_symbol_id = s2.id
+  WHERE cg.relation_type = 'call'
+  LIMIT 20
+"
+
+# 查询入口文件
+sds graph query --template entry-points
+
+# 查询循环依赖
+sds graph query --template circular-deps
+
+# 查询死代码
+sds graph query --template dead-code
+```
+
+---
+
+## Phase 3: 融合渲染（Fusion Rendering）
+
+**目标**: 将结构数据与语义数据融合为平台特定的引导文件。
+
+### 步骤
+
+1. **导出图谱（自动检测平台）**
+   - 检测当前平台：
+     - 存在 `.opencode/` 目录 → OpenCode 平台
+     - 存在 `CLAUDE.md` 或 `.claude/` 目录 → Claude Code 平台
+     - 两者都存在 → 同时生成两种格式
+   - OpenCode: 自动执行 `sds graph export --format agents-md`
+   - Claude Code: 自动执行 `sds graph export --format claude-md`
+   - 平台适配：
+     - **Claude Code**: 导出到 `.claude/CLAUDE.md`
+     - **OpenCode**: 导出到 `.opencode/AGENTS.md`
+
+2. **增强引导文件**
+   - 在引导文件中植入'图谱查询接口'说明
+   - 确保后续会话中 AI 知道如何查询图谱
+
+3. **保留传统章节**
+   - 确保生成的引导文件包含所有必要章节：
+     - Tech Stack
+     - Directory Structure
+     - Feature Overview（必须填写至少 1 行）
+     - Core User Flows（必须填写至少 1 条）
+     - Core Modules
+     - Data Flow
+     - External Integrations
+     - Configuration & Environment（必须填写至少 1 个变量）
+     - Build & Deploy（必须填写至少 1 条记录）
+     - Risk Areas / Tech Debt（必须填写至少 1 条风险）
+     - Test Coverage
+     - Development Constraints（必须填写至少 1 条约束）
+
+---
+
+## Phase 4: 认知验证（Cognition Verification）
+
+**目标**: 确保生成的引导文件质量达标。
+
+### 检查项
+
+- [ ] 结构覆盖率 > 80%（文件级）
+- [ ] 语义覆盖率 > 60%（核心模块有摘要）
+- [ ] 引导文件 Token 数 < 8000（防止上下文膨胀）
+- [ ] 关键调用链无断裂（CodeGraph 边完整性检查）
+- [ ] 语义摘要无自相矛盾（LLM 轻量校验）
+
+### 传统验证清单
+
+- [ ] `Feature Overview` 表格是否已填写？（至少 1 行有效数据）
+- [ ] `Core User Flows` 是否包含至少 1 条流程描述？
+- [ ] `Configuration & Environment` 是否包含至少 1 个环境变量？
+- [ ] `Build & Deploy` 是否包含至少 1 条构建或部署记录？
+- [ ] `Risk Areas` 是否包含至少 1 条风险？
+- [ ] `Development Constraints` 是否包含至少 1 条约束？
+- [ ] 若某项检查未通过，是否在对应章节标注了 `[INCOMPLETE: 原因]`？
+
+### 失败处理
+
+- 结构覆盖率不足 → 扩大 index 的 include 范围，重新执行 Phase 1
+- 语义摘要矛盾 → 对冲突文件重新执行 `sds graph enhance --files <conflict>`
+- 引导文件过大 → 启用'按需懒加载模式'
+
+---
+
+## Phase 5: Handoff to Superpowers
+
+引导文件就绪后，通知用户：
+
+"Codebase archaeology complete. CLAUDE.md/AGENTS.md is ready. You can now proceed with the Superpowers workflow: explore → brainstorming → propose → plan → apply → verify → archive."
+
+同时提供图谱查询接口：
+- **结构查询**: `sds graph query --sql "..."`
+- **语义查询**: `sds graph query --nl "..."`
+- **增量更新**: `sds graph diff`
+
+---
+
+## 与后续技能的衔接
+
+### 对 brainstorming 的输出
+
+```json
+{
+  "project_context": {
+    "architecture": "Clean Architecture + CQRS",
+    "modules": ["order", "payment", "inventory"],
+    "tech_stack": ["NestJS", "PostgreSQL"],
+    "entry_points": ["src/main.ts", "src/api/*.controller.ts"],
+    "data_flows": {
+      "order_creation": ["cart", "order", "payment", "inventory"]
+    }
+  },
+  "graph_query_interface": {
+    "structure": "sds graph query --sql '...'",
+    "semantic": "sds graph query --nl '...'"
+  }
+}
+```
+
+### 对 systematic-debugging 的输出
+
+- 提供 `sds graph query --template "call-chain" --from <error_file>` 快速定位调用链
+- 提供变更影响面分析：`sds graph query --sql "SELECT * FROM call_graph WHERE caller = '<file>'"`
+
+### 对 refactoring-assistant 的输出
+
+- 提供模块依赖图，评估重构影响范围
+- 提供循环依赖清单，识别优先解耦目标
+
+---
+
+## 错误处理
+
+| 错误场景 | 处理策略 |
+|---------|---------|
+| CodeGraph 解析失败（不支持的语法） | 跳过该文件，记录到 `.sds/graph-errors.log`，不影响整体索引 |
+| LLM API 限流/失败 | 降级为纯结构模式，引导文件中标注'语义分析未完成'，提示用户稍后重试 |
+| 项目过大（> 10k 文件） | 自动切换为'分层索引'：只索引 src/ 目录，忽略测试和构建产物 |
+| 循环依赖导致 enhance 递归溢出 | 设置调用链深度上限（10 层），超出部分标记为 'deep-circular' |
+
+---
+
+## 配置示例
+
+### 最小配置（纯结构模式，零成本）
+
+```yaml
+# .sds/graph.config.yaml
+enhance:
+  enabled: false
+```
+
+### 标准配置（结构+语义，平衡成本）
+
+```yaml
+enhance:
+  enabled: auto
+  depth: standard
+  max_files: 50
+  budget_tokens: 100000
+```
+
+### 深度配置（完整语义，高成本）
+
+```yaml
+enhance:
+  enabled: true
+  depth: deep
+  max_files: 200
+  budget_tokens: 500000
+  model: "claude-opus-4"
+```

package/skills/core/existing-code-caveman/skill.yaml

@@ -0,0 +1,12 @@
+id: "existing-code-caveman"
+version: "3.0.0"
+name: "project-cognition-hub"
+description: "项目认知中枢。通过结构索引（CodeGraph）+ 语义增强（Understand Anything）生成项目的完整认知图谱"
+category: "core"
+phase: "phase-0"
+source: "superpowers"
+dependencies: ["sds graph"]
+inputs: ["项目源码树", ".sds/graph.config.yaml"]
+outputs: [".sds/codegraph.db", ".sds/semantic-graph.json", "AGENTS.md / CLAUDE.md", ".sds/cognition-report.json"]
+size: "large"
+cache_ttl: "7d"

package/skills/core/opsx-apply/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: opsx-apply
+description: "Execute code changes from tasks.md. Follow TDD, one task at a time. Phase 4 of the SDS workflow."
+---
+
+# opsx:apply — 执行变更
+
+## 触发条件
+
+**触发**：
+- writing-plans 已完成，plan.md 或 plan/ 目录已就绪
+- 用户说"开始实现"、"执行"、"开始编码"
+
+**不触发**：
+- ❌ 任何非开发类对话
+- ❌ 计划尚未生成
+- ❌ 用户还在讨论计划
+
+根据计划中的任务列表，逐步执行代码变更。
+
+## SDS Workflow 位置
+
+**Phase 4** — 智能开发阶段
+
+```
+Phase 3          Phase 4            Phase 5
+writing-plans →  opsx:apply     →  opsx:verify
+                 │
+                 ├── subagent-driven-development（推荐）
+                 └── 手动执行
+```
+
+## 输入
+
+支持两种计划格式（自动检测）：
+
+### 模式 A: 目录化计划（计划较大时）
+
+```
+openspec/changes/<name>/
+├── plan/
+│   ├── index.md      ← 入口：执行顺序和状态
+│   ├── auth.md       ← 自包含：含接口契约 + 任务步骤
+│   └── user.md       ← 自包含：内联依赖接口
+├── specs.md
+└── tasks.md
+```
+
+### 模式 B: 单文件计划（默认）
+
+```
+openspec/changes/<name>/
+├── plan.md           ← 自包含：接口契约 + 所有任务
+├── specs.md
+└── tasks.md
+```
+
+### 检测逻辑
+
+1. 存在 `plan/` 目录 → 模式 A
+2. 否则 → 模式 B
+
+**两种模式对协调器的唯一区别：**
+- 模式 A：按 index.md 顺序逐 chunk 读取，每个 chunk 独立完整
+- 模式 B：直接读 plan.md 全文
+
+**不需要跨文件拼接上下文。**
+
+## 输出
+
+代码变更直接应用到项目中。
+
+## 执行方式
+
+### 方式 1: subagent-driven-development（推荐）
+
+```
+检测计划格式 → 读取计划
+↓
+模式 A: 按 index.md 顺序逐 chunk 处理
+  对每个 chunk:
+    读取该 chunk 文件（自包含，无需其他文件）
+    对 chunk 内每个任务:
+      提取任务文本 → 分派子代理 → 审查 → 标记完成
+    chunk 完成 → 更新 index.md 状态
+↓
+模式 B: 读取 plan.md 全文
+  对每个任务:
+    提取任务文本 → 分派子代理 → 审查 → 标记完成
+↓
+全部完成 → opsx:verify
+```
+
+### 方式 2: 手动执行
+
+在当前会话中按计划中列出的步骤逐一执行。
+
+## 流程
+
+1. **检测计划格式** — plan/ 目录 or plan.md
+2. **读取计划** — 自包含，一次读取即可
+3. **理解依赖关系** — 任务间依赖（在接口契约中声明）
+4. **按依赖顺序执行**
+   - 先执行无依赖的任务
+   - 每个任务遵循 TDD（红 → 绿 → 重构）
+5. **每个任务后验证**
+   - 运行测试确认通过
+   - 确保不破坏已有功能
+   - Commit
+6. **更新状态** — 任务的 `- [ ]` → `- [x]`
+7. **处理偏差**
+   - 计划有误 → 更新对应文件
+   - specs 不完整 → 更新 specs.md
+
+## 要点
+
+- **TDD 强制** — 先写测试再写实现
+- **小步提交** — 每个任务独立 commit
+- **不跳过审查** — 子代理模式必须做审查
+- **不并行实现** — 一次一个任务
+- **不需要跨文件拼接** — 每个 chunk / plan.md 自包含

package/skills/core/opsx-apply/skill.yaml

@@ -0,0 +1,12 @@
+id: "opsx:apply"
+version: "2.0.0"
+name: "apply-changes"
+description: "根据 tasks.md 执行变更"
+category: "core"
+phase: "phase-4"
+source: "openspec"
+dependencies: ["opsx:propose", "writing-plans"]
+inputs: ["openspec/changes/{name}/tasks.md"]
+outputs: []
+size: "large"
+cache_ttl: "7d"