dijk-skills 1.0.4 → 1.0.8

package/README.md

@@ -15,27 +15,41 @@ npm install -g dijk-skills
 npx dijk-skills install [options]
 ```
 
+### CLI Alias
+
+After `npm i -g dijk-skills`, both `dijk-skills` and the short alias `dijk` work: `dijk install`, `dijk -- openspec init`. Without a global install, use `npx -p dijk-skills dijk -- openspec init`, or plain `npx dijk-skills ...`.
+
+> Caveat: bare `npx dijk` does NOT resolve to this package — npx would look for an unrelated npm package named `dijk`. Always use `-p dijk-skills` or a global/local install.
+
 ### Options
 
 | Option | Description | Default |
 |--------|-------------|---------|
-| `--modules <list>` | Comma-separated module names | `common` |
+| `--modules <list>` | Comma-separated module names | `all` |
 | `--dir <path>` | Target installation directory | `~/.agents` |
 
 ### Modules
 
-| Module | Skills |
-|--------|--------|
-| `common` | caveman, grilling, handoff, humanizer-zh, i-have-adhd |
-| `writing` | grill-my-proposal, last30days, vibe-code-insight, vibe-opinion-insight |
-| `tools` | mcp-builder, skill-creator |
-| `coding` | *(empty, reserved for future skills)* |
+| Module | Skill | Description |
+|--------|-------|-------------|
+| `common` | caveman | 超压缩交流模式,在保持技术准确性的同时大幅节省输出 token(分 lite/full/ultra 档) |
+| `common` | grilling | 对计划、决策或想法进行不留情面的连环追问,压力测试你的思路 |
+| `common` | humanizer-zh | 去除文本中的 AI 生成痕迹,使其更自然、更像人类书写 |
+| `common` | i-have-adhd | 面向 ADHD 读者塑造输出:下一步行动置顶、多步任务编号、复述状态、抑制离题、给出时间预估 |
+| `writing` | grill-my-proposal | 把方案往死里问——三阶段递进追问(宏观结构→逐章深挖→交叉验证),动手前压力测试方案 |
+| `writing` | last30days | 研究任意话题近 30 天的真实讨论,覆盖 Reddit、X、YouTube、TikTok、Hacker News、Polymarket、GitHub 与全网 |
+| `writing` | vibe-code-insight | 对软件项目做深度系统分析,产出 `design.md`(系统设计)与 `trend.md`(生态与趋势洞察) |
+| `writing` | vibe-opinion-insight | Human 驱动的 AI Agent 技术洞察框架——Agent 是启发工具,Human 赋予意义并承担责任 |
+| `tools` | handoff | 将当前会话压缩为交接文档,供另一个 agent 接续工作 |
+| `tools` | mcp-builder | 构建高质量 MCP 服务器的指南,支持 Python(FastMCP)与 Node/TypeScript(MCP SDK) |
+| `tools` | skill-creator | 创建、编辑、评测与优化 skill,含触发准确率的基准测试 |
+| `coding` | *(reserved)* | 空——保留给未来的 skill |
 
 > Installing any module automatically includes `common`.
 
 ### Examples
 
-Install common skills to default location:
+Install all skills to default location:
 ```bash
 npx dijk-skills install
 ```
@@ -50,6 +64,26 @@ Custom target directory:
 npx dijk-skills install --modules coding --dir ~/my-agents
 ```
 
+## OpenSpec Bootstrap
+
+Bootstrap OpenSpec (`@fission-ai/openspec`) into a project for spec-driven development. Run it inside your project directory.
+
+```bash
+npx dijk-skills -- openspec init      # bootstrap the current project
+npx dijk-skills -- openspec <args...> # any other openspec command (pure passthrough)
+dijk -- openspec init                 # same, via the short alias
+```
+
+- Passthrough — forwards to `@fission-ai/openspec@latest` via npx, exit codes propagated
+- On `init` only: drops the customizable config template (`coding/openspec/config.yaml`) into `./openspec/` first (never overwrites an existing config) and defaults `--tools opencode --no-animation` unless you pass your own
+- Idempotent — re-run anytime to refresh CLI-owned files
+
+Default target is `opencode` (`.opencode/skills/openspec-*/` + `/opsx-*` commands). For the vendor-neutral shared target, pass `--tools agents` explicitly: writes `.agents/skills/openspec-*/` only (no `/opsx-*` command files; in opencode the skills are then invoked by name, e.g. `/openspec-propose`).
+
+**Prerequisites:** Node >= 20.19, network access for npx.
+
+**Customization:** edit the project's `openspec/config.yaml` (keys: `schema`, `context`, `rules`, `operations`), or edit the repo template (`coding/openspec/config.yaml`) to change defaults for future bootstraps.
+
 ## Installed Structure
 
 Skills are installed to `{dir}/skills/{skill-name}/`:

package/bin/dijk-skills.js

@@ -2,42 +2,59 @@
 
 import { parseArgs } from 'node:util';
 import { install } from '../lib/installer.js';
+import { runOpenspec } from '../lib/openspec.js';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const packageRoot = resolve(__dirname, '..');
 
-const { values, positionals } = parseArgs({
-  allowPositionals: true,
-  options: {
-    modules: {
-      type: 'string',
-      default: 'common'
-    },
-    dir: {
-      type: 'string',
-      default: '~/.agents'
-    },
-    help: {
-      type: 'boolean',
-      short: 'h'
+// Everything after the first `--` (npx may consume it), or all of argv
+const argv = process.argv.slice(2);
+const sepIdx = argv.indexOf('--');
+const effective = sepIdx !== -1 ? argv.slice(sepIdx + 1) : argv;
+
+if (effective[0] === 'openspec') {
+  // Passthrough to the OpenSpec CLI; lib owns exitCode + init output
+  await runOpenspec({ packageRoot, args: effective.slice(1), cwd: process.cwd() });
+} else {
+  const { values, positionals } = parseArgs({
+    args: effective,
+    allowPositionals: true,
+    options: {
+      modules: {
+        type: 'string',
+        default: 'all'
+      },
+      dir: {
+        type: 'string',
+        default: '~/.agents'
+      },
+      help: {
+        type: 'boolean',
+        short: 'h'
+      }
     }
-  }
-});
+  });
 
-const command = positionals[0];
+  const command = positionals[0];
 
-if (values.help || !command) {
-  console.log(`Usage: npx dijk-skills install [options]
+  if (values.help || !command) {
+    console.log(`Usage: npx dijk-skills <command> [options]
+       (short alias: dijk — after \`npm i -g dijk-skills\`, or \`npx -p dijk-skills dijk ...\`)
 
 Commands:
-  install    Install skills to target directory
+  install               Install skills to target directory
+  openspec <args...>    Run the OpenSpec CLI (passthrough via npx). Put it after
+                        \`--\` to be npx-safe: npx dijk-skills -- openspec init
+                        On \`init\`: drops the customizable coding/openspec/config.yaml
+                        template into ./openspec/ (never overwrites an existing
+                        config) and defaults --tools opencode --no-animation.
 
 Options:
   --modules <list>    Comma-separated module names or "all"
                       Values: coding,common,tools,writing,all
-                      Default: common
+                      Default: all
   --dir <path>        Target installation directory
                       Default: ~/.agents
   -h, --help          Show this help message
@@ -47,32 +64,40 @@ Examples:
   npx dijk-skills install --modules all
   npx dijk-skills install --modules writing,tools
   npx dijk-skills install --modules coding --dir ~/custom/path
+  npx dijk-skills -- openspec init
+  npx dijk-skills -- openspec update
+  npx dijk-skills -- openspec status
 `);
-  process.exit(0);
-}
+    process.exit(0);
+  }
 
-if (command !== 'install') {
-  console.error(`Unknown command: ${command}`);
-  console.error('Available commands: install');
-  process.exit(1);
-}
+  function expandTilde(path) {
+    return path.startsWith('~')
+      ? path.replace('~', process.env.HOME || process.env.USERPROFILE || '')
+      : path;
+  }
 
-const modules = values.modules === 'all'
-  ? ['coding', 'common', 'tools', 'writing']
-  : values.modules.split(',').map(m => m.trim()).filter(Boolean);
+  if (command !== 'install') {
+    console.error(`Unknown command: ${command}`);
+    console.error('Available commands: install, openspec');
+    process.exit(1);
+  }
 
-const targetDir = values.dir.startsWith('~')
-  ? values.dir.replace('~', process.env.HOME || process.env.USERPROFILE || '')
-  : values.dir;
+  const modules = values.modules === 'all'
+    ? ['coding', 'common', 'tools', 'writing']
+    : values.modules.split(',').map(m => m.trim()).filter(Boolean);
 
-try {
-  await install({
-    packageRoot,
-    modules,
-    targetDir: resolve(targetDir)
-  });
-  console.log('\n✓ Installation complete');
-} catch (err) {
-  console.error('Installation failed:', err.message);
-  process.exit(1);
+  const targetDir = expandTilde(values.dir);
+
+  try {
+    await install({
+      packageRoot,
+      modules,
+      targetDir: resolve(targetDir)
+    });
+    console.log('\n✓ Installation complete');
+  } catch (err) {
+    console.error('Installation failed:', err.message);
+    process.exit(1);
+  }
 }

package/coding/openspec/config.yaml

@@ -0,0 +1,32 @@
+schema: spec-driven
+
+rules:
+  proposal:
+  - 保持简洁，不描述实现方式；
+  - 背景：必须，包括变更背景、目标、动机；
+  - 术语表：必须，表格，包括 [中文-英文-解释]；
+  - 用户故事：必须，子章节，每一章包括 [> 叙事性描述]、[- 用户故事描述] 和 [**验收标准**]；
+  - 功能清单：必须，子章节，每一章包括 [> 描述]、[- 规格]、[**使用方式** （如界面操作/后台接口等）]、[影响]；
+  - 每一个功能对应一个 spec 文件；
+  - 修改 proposal 之后必须确保 proposal 其他章节以及 specs 和 design 同步满足； 
+
+  specs:
+  - 保持简洁，不描述实现细节；
+  - 功能需求（FR）：必须，包括ID、描述、1～N个用户场景（GIVEN/WHEN/THEN格式）；
+  - 非功能需求（NFR）：必须，包括ID、描述，范围包括可靠性、可用性、资源占用、性能、安全、容错、可观测等方面
+
+  design:
+  - 保持简洁；
+  - 上下文：必须，包括上游系统、下游系统、外部接口清单；
+  - 总体架构：必须，包括架构约束、各模块的逻辑架构和依赖关系、技术选型及理由；
+  - 必须包含设计决策记录（ADR），记录关键取舍及备选方案（为什么 X 而不是 Y）；
+  - 必须考虑非功能性需求的应对方案；
+  - 必须识别技术风险，并列出已知限制和后续演进方向；
+
+  tasks:
+  - 每个 task 须包含：用例编号、用例名称、前置条件、步骤、预期结果、验证方法；
+  - 必须关联 FR-ID 和 NFR-ID，确保可追溯；
+  - 必须包含单元测试（覆盖率 ≥ 80%）、集成测试、冒烟测试（如有）；
+  - 必须包含验收测试（与 specs 中的用户场景对应）、人工测试指导（如有）、构建与部署验证、数据准备方法、文档交付等；
+  - 缺陷必须分级（致命/重/一般/建议），并明确发布影响；
+

package/lib/openspec.js

@@ -0,0 +1,83 @@
+import { spawnSync } from 'node:child_process';
+import { copyFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * Drop the user-owned OpenSpec config template into <cwd>/openspec/.
+ * Never overwrites an existing config.yaml / config.yml.
+ */
+async function ensureConfigTemplate(cwd, packageRoot) {
+  await mkdir(join(cwd, 'openspec'), { recursive: true });
+
+  // Config is user-owned: only drop the template if no config exists yet
+  const configYaml = join(cwd, 'openspec', 'config.yaml');
+  const configYml = join(cwd, 'openspec', 'config.yml');
+
+  if (!existsSync(configYaml) && !existsSync(configYml)) {
+    await copyFile(join(packageRoot, 'coding', 'openspec', 'config.yaml'), configYaml);
+    console.log('✓  wrote openspec/config.yaml (template — customize freely)');
+  } else {
+    const existing = existsSync(configYaml) ? 'config.yaml' : 'config.yml';
+    console.log(`·  openspec/${existing} exists — keeping it (never overwritten)`);
+  }
+}
+
+/**
+ * Run the OpenSpec CLI (@fission-ai/openspec) via npx, forwarding args
+ * verbatim. On `init`: drops the config template first (never overwriting
+ * an existing config) and adds default flags `--tools opencode
+ * --no-animation` when the user didn't supply their own. Child exit codes
+ * propagate; this never throws.
+ */
+export async function runOpenspec({ packageRoot, args, cwd = process.cwd() }) {
+  const isInit = args[0] === 'init';
+
+  if (isInit) {
+    // OpenSpec requires Node >= 20.19.0 — warn, but do not abort
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    if (major < 20 || (major === 20 && minor < 19)) {
+      console.log(`⚠  OpenSpec requires Node >= 20.19.0 (current: ${process.versions.node}) — continuing anyway`);
+    }
+
+    console.log(`Target project: ${cwd}`);
+
+    await ensureConfigTemplate(cwd, packageRoot);
+
+    // Default flags, appended only when the user didn't supply their own
+    // (--tools also matches the equals form `--tools=<list>`)
+    const hasTools = args.some(a => a === '--tools' || a.startsWith('--tools='));
+    if (!hasTools) {
+      args = [...args, '--tools', 'opencode'];
+    }
+    if (!args.includes('--no-animation')) {
+      args = [...args, '--no-animation'];
+    }
+  }
+
+  const result = spawnSync('npx', ['-y', '@fission-ai/openspec@latest', ...args], {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32'
+  });
+
+  if (result.error) {
+    console.error(`Failed to run openspec via npx: ${result.error.message}`);
+    process.exitCode = 1;
+    return;
+  }
+
+  if (result.status !== 0) {
+    process.exitCode = result.status ?? 1;
+    return;
+  }
+
+  if (isInit) {
+    console.log(`✓  OpenSpec bootstrap complete
+   - Project config:  openspec/config.yaml  (yours — openspec never overwrites it)
+   - Agent skills:    .opencode/skills/openspec-*/
+   - Slash commands:  .opencode/commands/opsx-*.md  (/opsx-propose, /opsx-apply, ...)
+   - Vendor-neutral alternative: re-run with --tools agents for shared .agents/skills (skills only, no commands)
+   - Re-run anytime to refresh CLI-owned files; upgrade later with: npx @fission-ai/openspec@latest update`);
+  }
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "dijk-skills",
-  "version": "1.0.4",
+  "version": "1.0.8",
   "description": "CLI installer for Dijk skills collection",
   "type": "module",
   "bin": {
-    "dijk-skills": "./bin/dijk-skills.js"
+    "dijk-skills": "./bin/dijk-skills.js",
+    "dijk": "./bin/dijk-skills.js"
   },
   "files": [
     "bin/",