dsh-repo-setup 0.1.0 → 0.1.2

package/README.en.md

@@ -0,0 +1,77 @@
+# dsh-repo-setup
+
+[![npm version](https://img.shields.io/npm/v/dsh-repo-setup)](https://www.npmjs.com/package/dsh-repo-setup)
+[![GitHub release](https://img.shields.io/github/v/release/gongyijie85/dsh-repo-setup)](https://github.com/gongyijie85/dsh-repo-setup/releases)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2%2B-4d6bfe)](https://github.com/gongyijie85/dsh-repo-setup)
+[![-repo-scan](https://img.shields.io/badge/-repo--scan-4d6bfe)]() [![-read-only](https://img.shields.io/badge/-read--only-4d6bfe)]() [![-recommend-install](https://img.shields.io/badge/-recommend--install-4d6bfe)]() [![-MCP](https://img.shields.io/badge/-MCP-4d6bfe)]()
+
+Repo bootstrap guidance for the **DeepSeek Harness (DSH)** — the counterpart of
+Anthropic's **claude-code-setup**.
+
+Registers one **read-only** tool, `repo_setup_scan`: it inspects a project
+directory (language stack, test setup, docs, git, Docker and database hints)
+and returns setup recommendations — which DSH skill plugins to install, which
+MCP servers to mount, which hygiene files to create. **It never modifies
+anything.**
+
+## Install
+
+```sh
+# npm
+dsh plugin --profile web add dsh-repo-setup
+
+# GitHub
+dsh plugin --profile web add github:gongyijie85/dsh-repo-setup
+
+# Local folder (development)
+dsh plugin --profile web add D:\plugins\dsh-repo-setup
+```
+
+Restart the profile (`dsh web`). The model then calls `repo_setup_scan`
+automatically when entering a new or unfamiliar repository (or just ask:
+"scan this repo and tell me how to set it up").
+
+## Tool: repo_setup_scan
+
+| Parameter | Description |
+| --- | --- |
+| `path` | Project directory to scan. Defaults to the current working directory. |
+
+Outputs a Markdown report:
+
+- **Detected stack** — stack markers (package.json / pyproject.toml /
+  Cargo.toml / go.mod / Dockerfile, ...) including frontend frameworks and
+  test runners
+- **Repo hygiene** — missing AGENTS.md, git not initialized, no tests,
+  database hints
+- **Recommended installs** — one-command installs:
+  - `mattpocock-skills-dsh` (grilling / to-spec / to-tickets / tdd /
+    code-review workflow)
+  - `superpowers-dsh` (planning → TDD → review methodology)
+  - `dsh-ponytail-skills` (anti-over-engineering)
+  - `dsh-claude-mem` (optional: cross-session memory)
+  - `dsh-mcp-manager` (to mount the MCP servers below)
+  - MCP servers: context7 (library docs), playwright (frontend), postgres,
+    github (depending on what the scan detects)
+
+## How it works
+
+- **Bundle layer** — `cordis.patch.yml` inserts a plugin row over the dsh-base
+  layer.
+- **Tool** — `lib/index.js` registers `repo_setup_scan` with `defineTool`
+  from `@deepseek-ai/dsh-tools`; the scan is read-only (a bounded set of known
+  files + top-level directory listing), with no writes at all.
+- **Zero runtime dependencies** — Node built-ins plus the harness-injected
+  `@deepseek-ai/dsh-tools` peer dependency.
+
+## Development / verification
+
+```sh
+node --check lib/index.js
+node scripts/verify-tool.mjs   # fake-ctx registration + scan against real dirs
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/README.md

@@ -1,5 +1,18 @@
 # dsh-repo-setup
 
+[![npm version](https://img.shields.io/npm/v/dsh-repo-setup)](https://www.npmjs.com/package/dsh-repo-setup)
+[![GitHub release](https://img.shields.io/github/v/release/gongyijie85/dsh-repo-setup)](https://github.com/gongyijie85/dsh-repo-setup/releases)
+[![CI](https://github.com/gongyijie85/dsh-repo-setup/actions/workflows/ci.yml/badge.svg)](https://github.com/gongyijie85/dsh-repo-setup/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2%2B-4d6bfe)](https://github.com/gongyijie85/dsh-repo-setup)
+[![-仓库体检](https://img.shields.io/badge/-仓库体检-4d6bfe)]() [![-只读扫描](https://img.shields.io/badge/-只读扫描-4d6bfe)]() [![-推荐安装](https://img.shields.io/badge/-推荐安装-4d6bfe)]() [![-MCP](https://img.shields.io/badge/-MCP-4d6bfe)]()
+
+<div align="center">
+
+[English](README.en.md) | **简体中文**
+
+</div>
+
 仓库体检引导插件 —— Anthropic **claude-code-setup** 的 DeepSeek Harness 版。
 
 注册一个**只读**工具 `repo_setup_scan`:扫描项目目录的语言栈、测试设置、
@@ -8,6 +21,8 @@
 
 ## 安装
 
+**支持的 DSH 版本**：`>=0.1.1-rc.2`（已在上线版本验证，兼容更高版本）。
+
 ```sh
 # npm
 dsh plugin --profile web add dsh-repo-setup
@@ -35,8 +50,12 @@ dsh plugin --profile web add D:\plugins\dsh-repo-setup
 - **Repo hygiene** — AGENTS.md 缺失、git 未初始化、无测试、数据库线索
 - **Recommended installs** — 一键命令:
   - `mattpocock-skills-dsh`(grilling/to-spec/to-tickets/tdd/code-review 工作流)
+  - `mattpocock-skills-dsh-zh`(中文技能版,与英文版二选一)
   - `superpowers-dsh`(规划→TDD→评审方法论)
-  - `dsh-ponytail`(防过度工程)
+  - `dsh-ponytail-skills`(防过度工程)
+  - `dsh-ecc-skills`(ECC 273 技能:模式/编排/垂直领域)
+  - `dsh-claude-mem`(可选:跨会话记忆)
+  - `dsh-mcp-manager`(挂载下方 MCP 用)
   - MCP:context7(库文档)、playwright(前端)、postgres、github(按检测结果)
 
 ## 工作原理

package/dsh.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "gongyijie85/dsh-repo-setup",
+  "version": "0.1.2",
+  "main": "./lib/index.js",
+  "description": "Repo bootstrap guidance for DeepSeek Harness: read-only repo_setup_scan tool that detects stack/tests/docs/git/db and recommends skill plugins, MCP servers and hygiene files to install (claude-code-setup counterpart)",
+  "engines": {
+    "dsh": ">=0.1.1-rc.2"
+  },
+  "contributes": {
+    "tools": [
+      "repo_setup_scan"
+    ],
+    "skills": []
+  }
+}

package/lib/index.js

@@ -138,9 +138,11 @@ async function scanRepo(root) {
   installs.push('superpowers-dsh — brainstorming → plans → TDD → review methodology')
   installs.push('dsh-ponytail — lazy senior dev mode (anti-over-engineering)')
   if (hasTests || stacks.some((s) => s.includes('test'))) installs.push('(tdd skill is included in both packs above)')
-  lines.push(`- \`dsh plugin --profile web add github:gongyijie85/mattpocock-skills-dsh\``)
-  lines.push(`- \`dsh plugin --profile web add github:LayneChai/superpowers-dsh\``)
-  lines.push(`- \`dsh plugin --profile web add github:gongyijie85/dsh-ponytail\``)
+  lines.push(`- \`dsh plugin --profile web add mattpocock-skills-dsh\``)
+  lines.push(`- \`dsh plugin --profile web add superpowers-dsh\``)
+  lines.push(`- \`dsh plugin --profile web add dsh-ponytail-skills\``)
+  lines.push(`- \`dsh plugin --profile web add dsh-ecc-skills\`  (ECC skills, 273 curated)`)
+  lines.push(`- \`dsh plugin --profile web add mattpocock-skills-dsh-zh\`  (中文技能版,二选一 with the English pack)`)
   lines.push(`- \`dsh plugin --profile web add github:Bleed00/dsh-claude-mem\`  (optional: cross-session memory)`)
   lines.push(`- \`dsh plugin --profile web add github:Nichts0v0/dsh-mcp-manager\`  (to mount the MCP servers below)`)
   if (stacks.some((s) => s.includes('Node') || s.includes('Rust') || s.includes('Python') || s.includes('Go'))) {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "dsh-repo-setup",
   "description": "Repo bootstrap guidance for DeepSeek Harness: read-only repo_setup_scan tool that detects stack/tests/docs/git/db and recommends skill plugins, MCP servers and hygiene files to install (claude-code-setup counterpart)",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
+  "engines": {
+    "dsh": ">=0.1.1-rc.2"
+  },
   "main": "lib/index.js",
   "exports": {
     ".": "./lib/index.js",
@@ -11,8 +14,10 @@
   },
   "files": [
     "lib",
+    "dsh.plugin.json",
     "cordis.patch.yml",
     "README.md",
+    "README.en.md",
     "LICENSE"
   ],
   "license": "MIT",
@@ -44,6 +49,11 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.1.1-rc.2": "compatible"
+      }
     }
   }
 }