diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 3233d3f84..1efd06955 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -11,7 +11,7 @@ { "name": "ecc", "source": "./", - "description": "Harness-native ECC operator layer - 71 agents, 303 skills, 97 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses", + "description": "Harness-native ECC operator layer - 71 agents, 304 skills, 97 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses", "version": "2.2.3", "author": { "name": "Affaan Mustafa", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index b1b0e5d6d..58bf166ca 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ecc", "version": "2.2.3", - "description": "Harness-native ECC plugin for engineering teams - 71 agents, 303 skills, 97 legacy command shims, reusable hooks, rules, MCP conventions, and operator workflows for Claude Code plus adjacent agent harnesses", + "description": "Harness-native ECC plugin for engineering teams - 71 agents, 304 skills, 97 legacy command shims, reusable hooks, rules, MCP conventions, and operator workflows for Claude Code plus adjacent agent harnesses", "author": { "name": "Affaan Mustafa", "url": "https://x.com/affaanmustafa" diff --git a/.gemini/GEMINI.md b/.gemini/GEMINI.md index 28191720d..c04d415d7 100644 --- a/.gemini/GEMINI.md +++ b/.gemini/GEMINI.md @@ -4,7 +4,7 @@ This file provides Gemini CLI with the baseline ECC workflow, review standards, ## Overview -ECC is a cross-harness coding system with 71 specialized agents, 303 skills, and 97 commands. +ECC is a cross-harness coding system with 71 specialized agents, 304 skills, and 97 commands. Gemini support is currently focused on a strong project-local instruction layer via `.gemini/GEMINI.md`, plus the shared MCP catalog and package-manager setup assets shipped by the installer. diff --git a/.qoder-plugin/plugin.json b/.qoder-plugin/plugin.json index c76c97f9b..3a45eba99 100644 --- a/.qoder-plugin/plugin.json +++ b/.qoder-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "ecc", "displayName": "ECC", "version": "2.2.3", - "description": "Harness-native engineering workflows for Qoder: 302 skills, 71 agents, legacy command shims, a reviewed SessionStart hook, and optional MCP tooling.", + "description": "Harness-native engineering workflows for Qoder: canonical skills and agents, legacy command shims, a reviewed SessionStart hook, and optional MCP tooling.", "author": { "name": "Affaan Mustafa", "url": "https://x.com/affaanmustafa" diff --git a/AGENTS.md b/AGENTS.md index 410eb49f2..0dd3ecc25 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # ECC — Agent Instructions -This is a **production-ready AI coding plugin** providing 71 specialized agents, 303 skills, 97 commands, and automated hook workflows for software development. +This is a **production-ready AI coding plugin** providing 71 specialized agents, 304 skills, 97 commands, and automated hook workflows for software development. **Version:** 2.2.3 @@ -202,7 +202,7 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat ``` agents/ — 71 specialized subagents -skills/ — 303 workflow skills and domain knowledge +skills/ — 304 workflow skills and domain knowledge commands/ — 97 slash commands hooks/ — Trigger-based automations rules/ — Always-follow guidelines (common + per-language) diff --git a/README.md b/README.md index 6744d1a72..5a36d37b6 100644 --- a/README.md +++ b/README.md @@ -140,12 +140,12 @@ Instead of rebuilding that process in every prompt, you install it once and make ECC is MIT-licensed open source. It works best with Claude Code today, has native Codex and Qoder plugin paths, and provides capability-limited adapters for Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen, and other harnesses. See the [support status matrix](#platform-support) before assuming feature parity. -Access to 71 agents, 303 skills, and 97 legacy command shims, plus hooks, rules, memory, continuous learning, and AgentShield security scanning. The agents are specialized for planning, review, build repair, security, architecture, and domain work. +Access to 71 agents, 304 skills, and 97 legacy command shims, plus hooks, rules, memory, continuous learning, and AgentShield security scanning. The agents are specialized for planning, review, build repair, security, architecture, and domain work. | Included | Count | What it gives you | | ---------------- | ----------: | ------------------------------------------------------------------------------------ | | Agents | 71 agents | Planning, review, build repair, security, architecture, and domain work | -| Skills | 303 skills | TDD, research, security, docs, frontend, data, ML, operations, and more | +| Skills | 304 skills | TDD, research, security, docs, frontend, data, ML, operations, and more | | Commands | 97 commands | Convenient entry points while ECC moves to a skills-first surface | | Hooks and memory | Runtime | Enforcement, session summaries, continuous learning, instincts, and context controls | | Rules | Selective | Always-loaded standards you choose by language or project | @@ -385,7 +385,7 @@ For repo navigation, surface ownership, and PR diff packet guidance, read the [C ### Qoder CLI and IDE -ECC ships a native Qoder plugin that reuses the canonical 302 skills, 71 agents, +ECC ships a native Qoder plugin that reuses the canonical skills, agents, 95 legacy command shims, and the pinned `chrome-devtools` MCP definition. From a reviewed checkout, validate and install it with Qoder CLI: diff --git a/README.zh-CN.md b/README.zh-CN.md index fb4d14987..26abefd3c 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -200,7 +200,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/" /plugin list ecc@ecc ``` -**完成！** 你现在可以使用 71 个代理、303 个技能和 97 个命令。 +**完成！** 你现在可以使用 71 个代理、304 个技能和 97 个命令。 ### multi-* 命令需要额外配置 diff --git a/SOUL.md b/SOUL.md index 567beed5d..4fb85aff0 100644 --- a/SOUL.md +++ b/SOUL.md @@ -1,7 +1,7 @@ # Soul ## Core Identity -ECC is a production-ready AI coding plugin with 71 specialized agents, 303 skills, 97 commands, and automated hook workflows for software development. +ECC is a production-ready AI coding plugin with 71 specialized agents, 304 skills, 97 commands, and automated hook workflows for software development. ## Core Principles 1. **Agent-First** — route work to the right specialist as early as possible. diff --git a/docs/DEEPSEEK-HARNESS-GUIDE.md b/docs/DEEPSEEK-HARNESS-GUIDE.md new file mode 100644 index 000000000..055ef24d6 --- /dev/null +++ b/docs/DEEPSEEK-HARNESS-GUIDE.md @@ -0,0 +1,143 @@ +# DeepSeek Harness Guide + +ECC runs on the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) via its +native skill roots and the first-party Claude Code hooks bridge. This guide covers +what works out of the box, how to mount the ECC hooks, and the current limits. + +Unlike the Qwen or Codex adapters, there is no dedicated installer target yet; the +setup is a small amount of manual configuration described below. + +## Prerequisites + +- DeepSeek Harness 0.2.0-rc.1 (the verified version; reverify newer releases) (`dsh --version`). +- ECC repository cloned locally, for example `~/ECC` (the hooks bridge commands + reference this path, so keep the checkout in place). +- Skills need no extra tooling; hooks use the `@deepseek-ai/dsh-hooks-claude-code` + plugin that ships inside the DSH runtime itself. + +## Skills (automatic) + +DSH loads skills from these roots (earlier roots win on name conflicts): + +```text +/.dsh/skills +/.agents/skills +custom dirs (~/.dsh/profiles//cordis.patch.yml -> skill-filesystem) +~/.dsh/skills +~/.agents/skills +``` + +Because ECC already ships `.agents/skills/` for Codex, opening a session with the +ECC checkout as the working directory exposes a subset of ECC skills immediately. +To expose the full curated set in every project, link the catalog once: + +```bash +ln -s /path/to/ECC/skills/ ~/.dsh/skills/ +``` + +Run this per skill with real names substituted for both placeholders (for +example `ln -s ~/ECC/skills/tdd-workflow ~/.dsh/skills/tdd-workflow`); the +angle brackets are placeholders, not shell syntax. + +DSH reads `SKILL.md` frontmatter (name/description), which matches the ECC skill +format, so no conversion is needed. Name conflicts with pre-existing user skills +are resolved by root priority; skip those skills when linking. + +## Hooks + +### How the bridge works + +DSH bridges ECC command hooks through `@deepseek-ai/dsh-hooks-claude-code` +(first-party, bundled with the runtime). Constraints that shape the conversion: + +- Supported events: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, + `PostToolUse`, `Stop`, `SubagentStart`, `SubagentStop`. ECC events without a + bridge counterpart (`PreCompact`, `PostToolUseFailure`, `SessionEnd`) are + skipped by the generator. +- DSH tool names are lower-case (`bash`, `edit`, `write`, `skill`, `task`), + while ECC matchers use Claude Code names (`Bash`, `Edit|MultiEdit`, ...). The + generator maps known tool names and keeps regex passthrough tokens. +- The bridge runs commands with `bash -c` and does not export the plugin root as + an environment variable for hook processes. The generator prefixes each command + with `CLAUDE_PLUGIN_ROOT= ECC_PLUGIN_ROOT=` (env-prefix + form), which the ECC hook bootstrap reads at startup. +- `timeout` values are seconds in both formats and are preserved. + +### Generate the config + +```bash +node scripts/dsh/generate-hooks-config.js --ecc-root /path/to/ECC --out ~/.dsh/ecc/hooks-dsh.json +``` + +The script validates nothing about your DSH install; it only converts +`hooks/hooks.json` into the bridge format and prints what it skipped. + +### Mount into a profile + +Add a bare insert entry to the profile patch layer +(`~/.dsh/profiles//cordis.patch.yml`). This mirrors how the bundled web +app preset mounts its plugins: + +```yaml +- insert: + - id: ecc-hooks-claude-code + name: "@deepseek-ai/dsh-hooks-claude-code" + config: + configPath: /absolute/path/to/hooks-dsh.json +``` + +Configuration notes from practice: + +- A plain top-level entry (`- id: ...`) is silently dropped; the loader only + treats `insert` entries as additions. +- `insert` under an existing non-group id is rejected ("not a group"); use a bare + insert without a target id. +- The plugin package does not need to be added to the profile `package.json`; + first-party plugins resolve from the DSH runtime install. +- Validate without booting: `cd ~/.dsh && dsh --profile --dump-config` + (compose errors and dropped entries are reported on stderr). + +### Verify + +```bash +# Compose check (no session boot). Keep stderr visible: silently dropped or +# rejected patch entries are reported there while the exit status stays 0. +cd ~/.dsh && dsh --profile web --dump-config > /tmp/dump.yml + +grep ecc-hooks /tmp/dump.yml + +# End-to-end: fire a SessionStart hook in a one-shot headless session +# (uses a test config with a single marker-writing hook) +dsh --profile headless --patch /tmp/ecc-patch-test.yml 'Reply with exactly: BOOT-OK' +``` + +A successful compose does not prove the entry mounted: dropped entries and +"is not a group" rejections only appear on stderr, never in the exit status. +Confirm the entry id exists in the dump and that stderr was empty. + +In a live web session, the GateGuard fact-forcing hook denies the first +edit/write/bash attempt until facts are presented — a visible signal that the +bridge is active. + +## Updating + +```bash +cd /path/to/ECC && git pull +node scripts/dsh/generate-hooks-config.js --ecc-root /path/to/ECC --out ~/.dsh/ecc/hooks-dsh.json +``` + +Linked skills reflect the pull immediately (symlinks), only the hooks config +needs regeneration. + +## Scope + +| Surface | Status on DSH | +|---------|---------------| +| Skills | Native discovery; individual workflows retain their harness prerequisites | +| Hooks (23 command hooks, 5 of 7 events) | Works via the bridge; 3 events unsupported | +| Commands (slash-command surface) | Not available (Claude Code mechanism); workflows are covered by skills | +| Agents | Native dispatch unverified; use canonical prompt guidance only after review | + +The validated setup here targets the CLI/web profile. Desktop profiles have a separate +installation-owned runtime and skill discovery must be verified there independently. +Generate hooks only from a reviewed ECC checkout; the linked checkout supplies their runtime. diff --git a/docs/architecture/harness-adapter-compliance.md b/docs/architecture/harness-adapter-compliance.md index 97588546f..c2efea563 100644 --- a/docs/architecture/harness-adapter-compliance.md +++ b/docs/architecture/harness-adapter-compliance.md @@ -44,6 +44,7 @@ The matrix below is rendered from | Gemini | Instruction-backed | Gemini project-local instructions; shared skills; rules; compatibility docs | No full ECC hook parity; ecosystem ports must document drift from upstream ECC | `./install.sh --profile minimal --target gemini` | `node tests/lib/install-targets.test.js` | Treat Gemini ports as ecosystem adapters until validated end to end inside Gemini CLI. | | Zed | Adapter-backed | Zed project settings; flattened project rules; shared skills; commands; agents | Zed external agents and native Agent Panel permissions are not Claude hooks | `./install.sh --profile minimal --target zed` | `node tests/lib/install-targets.test.js`; `npm run harness:audit -- --format json` | Keep project settings conservative and do not copy BYOK/OpenRouter secrets into `.zed/`. | | dmux | Adapter-backed | session snapshots; tmux/worktree orchestration status; handoff exports | dmux is an orchestration runtime, not an install target for skills/rules | `node scripts/session-inspect.js --list-adapters`; dmux session target inspection | `node tests/lib/session-adapters.test.js` | Treat dmux events as session/runtime signals, not as a replacement for repo validation. | +| DeepSeek Harness | Adapter-backed | canonical ECC skills (skills/) via native DSH skill roots; command hooks through the first-party @deepseek-ai/dsh-hooks-claude-code bridge (23 commands on 5 of 7 bridged events); hooks config generator (scripts/dsh/generate-hooks-config.js); profile patch mounting with compose-time validation | Claude slash commands and ECC subagent surfaces have no DSH equivalent; workflows are covered by skills; PreCompact, PostToolUseFailure, and SessionEnd hook events have no bridge counterpart; no dedicated installer target; setup is documented manual configuration | link the curated catalog: ln -s /path/to/ECC/skills/ ~/.dsh/skills/; generate the hooks config: node scripts/dsh/generate-hooks-config.js --ecc-root /path/to/ECC --out ~/.dsh/ecc/hooks-dsh.json; mount a bare - insert: entry for @deepseek-ai/dsh-hooks-claude-code in ~/.dsh/profiles//cordis.patch.yml | `node tests/scripts/dsh-generate-hooks-config.test.js`; `node scripts/ci/validate-skills.js`; `dsh --profile --dump-config` (compose-time validation) | Hook commands embed the ECC checkout path; regenerate the hooks config after moving the repo; Keep the tool-name matcher mapping (Bash to bash, Edit/MultiEdit to edit) in sync with DSH tool names; A plain top-level patch entry is silently dropped; additions require a bare insert entry | | Orca | Reference-only | worktree lifecycle; review state; notification; provider-identity design pressure | No ECC installer or direct adapter today | Use as a comparison target for worktree/session state requirements | `npm run observability:ready` | Do not import product-specific assumptions; convert lessons into ECC event fields. | | Superset | Reference-only | workspace presets; parallel-agent review loops; worktree isolation design pressure | No ECC installer or direct adapter today | Use as a comparison target for workspace preset taxonomy | `npm run observability:ready` | Keep ECC portable; do not require a desktop workspace to get basic value. | | Ghast | Reference-only | terminal-native pane grouping; cwd grouping; search; notifications | No ECC installer or direct adapter today | Use as a comparison target for terminal-first session grouping | `node scripts/session-inspect.js --list-adapters` | Preserve terminal ergonomics before adding visual UI assumptions. | diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.md index 9b92a9b6c..25772a6fe 100644 --- a/docs/zh-CN/AGENTS.md +++ b/docs/zh-CN/AGENTS.md @@ -1,6 +1,6 @@ # ECC — 智能体指令 -这是一个**生产就绪的 AI 编码插件**，提供 71 个专业代理、303 项技能、97 条命令以及自动化钩子工作流，用于软件开发。 +这是一个**生产就绪的 AI 编码插件**，提供 71 个专业代理、304 项技能、97 条命令以及自动化钩子工作流，用于软件开发。 **版本:** 2.2.3 @@ -147,7 +147,7 @@ ``` agents/ — 71 个专业子代理 -skills/ — 303 个工作流技能和领域知识 +skills/ — 304 个工作流技能和领域知识 commands/ — 97 个斜杠命令 hooks/ — 基于触发的自动化 rules/ — 始终遵循的指导方针（通用 + 每种语言） diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index 2f512efdc..490545ada 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -264,7 +264,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/" /plugin list ecc@ecc ``` -**搞定！** 你现在可以使用 71 个智能体、303 项技能和 97 个命令了。 +**搞定！** 你现在可以使用 71 个智能体、304 项技能和 97 个命令了。 *** @@ -1178,7 +1178,7 @@ opencode |---------|---------------|----------|--------| | 智能体 | PASS: 71 个 | PASS: 12 个 | **Claude Code 领先** | | 命令 | PASS: 97 个 | PASS: 35 个 | **Claude Code 领先** | -| 技能 | PASS: 303 项 | PASS: 37 项 | **Claude Code 领先** | +| 技能 | PASS: 304 项 | PASS: 37 项 | **Claude Code 领先** | | 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多！** | | 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** | | MCP 服务器 | PASS: 14 个 | PASS: 完整 | **完全对等** | @@ -1286,7 +1286,7 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以 |---------|-----------------------|------------|-----------|----------| | **智能体** | 71 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 | | **命令** | 97 | 共享 | 基于指令 | 35 | -| **技能** | 303 | 共享 | 10 (原生格式) | 37 | +| **技能** | 304 | 共享 | 10 (原生格式) | 37 | | **钩子事件** | 8 种类型 | 15 种类型 | SessionStart（1 种类型） | 11 种类型 | | **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | 1 个 SessionStart 引导脚本 | 插件钩子 | | **规则** | 34 (通用 + 语言) | 34 (YAML 前页) | 基于指令 | 13 条指令 | diff --git a/manifests/context-packs/skill-triggers@1.json b/manifests/context-packs/skill-triggers@1.json index 5c15f0514..3ee3177c6 100644 --- a/manifests/context-packs/skill-triggers@1.json +++ b/manifests/context-packs/skill-triggers@1.json @@ -10,7 +10,7 @@ "id": "hand-seeded", "source": "manual-curation-pending-regeneration" }, - "registryDigest": "cc5b64b326164acd4241f1ccd74dd0cd75a92550afcc76561e02a3e4eb2eb240", + "registryDigest": "280c821f48ecc538706e75d13175ec7707ade0d307b74f3c865d29edc6f39167", "schemaVersion": 1, "triggers": { "skill:api-connector-builder": [ diff --git a/manifests/install-modules.json b/manifests/install-modules.json index a1037e268..034f2c04c 100644 --- a/manifests/install-modules.json +++ b/manifests/install-modules.json @@ -358,6 +358,7 @@ "skills/agent-introspection-debugging", "skills/ai-regression-testing", "skills/configure-ecc", + "skills/deepseek-harness-setup", "skills/code-tour", "skills/continuous-learning", "skills/continuous-learning-v2", diff --git a/package.json b/package.json index e42f0c1ec..0e1c4ca24 100644 --- a/package.json +++ b/package.json @@ -118,6 +118,7 @@ "scripts/consult.js", "scripts/profile.js", "scripts/astra-review.js", + "scripts/dsh/generate-hooks-config.js", "scripts/auto-update.js", "scripts/claw.js", "scripts/control-pane.js", @@ -226,6 +227,7 @@ "skills/data-scraper-agent/", "skills/database-migrations/", "skills/deep-research/", + "skills/deepseek-harness-setup/", "skills/defi-amm-security/", "skills/deployment-patterns/", "skills/dev-team/", diff --git a/scripts/dsh/generate-hooks-config.js b/scripts/dsh/generate-hooks-config.js new file mode 100644 index 000000000..02e7abf93 --- /dev/null +++ b/scripts/dsh/generate-hooks-config.js @@ -0,0 +1,165 @@ +#!/usr/bin/env node +/** + * Generate a DeepSeek Harness (DSH) hooks config from hooks/hooks.json. + * + * DSH bridges ECC command hooks through the first-party plugin + * @deepseek-ai/dsh-hooks-claude-code. The bridge supports a subset of + * Claude Code hook events and lower-cases tool names in matchers, so this + * script converts the canonical ECC hooks.json into a DSH-compatible file. + * + * Usage: + * node scripts/dsh/generate-hooks-config.js [--ecc-root ] [--out ] + * + * Defaults: + * --ecc-root directory of this checkout (repo root) + * --out /hooks/hooks.dsh.json + * + * The output is a Claude Code hooks-format file consumed by the bridge: + * { "hooks": { "PreToolUse": [ { "matcher": "...", "hooks": [...] } ] } } + * + * Unsupported ECC events (no DSH bridge counterpart) are skipped and + * reported on stderr: PreCompact, PostToolUseFailure, SessionEnd. + */ +'use strict'; + +const fs = require('fs'); +const path = require('path'); + +const SUPPORTED_EVENTS = new Set([ + 'SessionStart', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'Stop', + 'SubagentStart', 'SubagentStop', +]); + +// Claude Code tool names -> DSH lower-case tool names used by the bridge. +const TOOL_NAME_MAP = { + Bash: 'bash', + PowerShell: 'powershell', + Write: 'write', + Edit: 'edit', + MultiEdit: 'edit', + Skill: 'skill', + Task: 'task', +}; + +function parseArgs(argv) { + const opts = { eccRoot: null, out: null }; + for (let i = 2; i < argv.length; i++) { + const a = argv[i]; + if (a === '--ecc-root' || a === '--out') { + const value = argv[++i]; + if (value === undefined || value.startsWith('--')) { + process.stderr.write('Missing value for ' + a + '\n'); + process.exit(2); + } + if (a === '--ecc-root') opts.eccRoot = value; + else opts.out = value; + } + else { + process.stderr.write('Unknown argument: ' + a + '\n'); + process.exit(2); + } + } + return opts; +} + +/** + * Map a Claude Code matcher expression to DSH tool-name tokens. + * Split on |, map known tool names to lower-case DSH names, keep regex + * passthrough tokens (like .* or ^mcp__) untouched, de-duplicate. + */ +function mapMatcher(matcher) { + if (typeof matcher !== 'string' || matcher.length === 0) return matcher; + const parts = matcher.split('|').map(function (t) { + const v = t.trim(); + if (v === '' || /^\^?mcp__/.test(v) || /[\\^$.*+?()[\]{}]/.test(v)) return v; + const mapped = TOOL_NAME_MAP[v]; + return mapped !== undefined ? mapped : v.toLowerCase(); + }); + return Array.from(new Set(parts)).join('|'); +} + +/** + * Rewrite an ECC command into a DSH bridge command. + * + * The bridge runs commands with bash -c but does not export the plugin + * root as an environment variable for every hook process. Each ECC hook + * command embeds a resolver (`node -e "..."