dijk-skills 1.0.0

package/README.md

@@ -0,0 +1,193 @@
+# dijk-skills
+
+AI 编码助手的 Skills 集合，遵循 [Agent Skills 规范](https://agentskills.io)。
+
+支持 OpenCode、Claude Code、Codex、Cursor 等 70+ AI 编码助手。
+
+## 安装
+
+### 方式一：`npx skills`（推荐）
+
+使用 [vercel-labs/skills](https://github.com/vercel-labs/skills) 生态标准安装，无需发布：
+
+```bash
+# 从本地路径安装所有 skills
+npx skills add /path/to/dijk-skills --skill '*' -g -y
+
+# 安装到指定 agent
+npx skills add /path/to/dijk-skills -a opencode -g -y
+npx skills add /path/to/dijk-skills -a claude-code -g -y
+
+# 只安装某个 skill
+npx skills add /path/to/dijk-skills --skill darwin-skill -g -y
+
+# 预览可用 skills（不安装）
+npx skills add /path/to/dijk-skills --list
+```
+
+如果将此项目推送到独立 GitHub 仓库，还可以直接用仓库名安装：
+
+```bash
+npx skills add your-username/dijk-skills -g -y
+```
+
+### 方式二：`npx dijk-skills`
+
+通过自定义安装脚本，支持 `--dir` 自定义目标目录：
+
+```bash
+# 本地路径（无需发布）
+npx /path/to/dijk-skills
+
+# 指定目录
+npx /path/to/dijk-skills --dir ~/.config/opencode
+
+# 发布到 npm 后
+npx dijk-skills
+npx dijk-skills --dir ~/.config/opencode
+```
+
+## 包含内容
+
+| Skill | 说明 |
+|-------|------|
+| `darwin-skill` | Skill 自主优化器，基于 SkillLens 9 维评估 |
+| `grilling` | 方案压力测试，三阶段递进追问 |
+| `humanizer-zh` | 去除中文文本 AI 生成痕迹 |
+| `i-have-adhd` | ADHD 友好输出模式 |
+| `skill-creator` | Skill 创建指南 |
+
+安装后位于：
+
+```
+~/.agents/skills/           # OpenCode / Amp / Codex
+~/.claude/skills/           # Claude Code
+# 取决于 --agent 参数
+├── darwin-skill/
+├── grilling/
+├── humanizer-zh/
+├── i-have-adhd/
+└── skill-creator/
+```
+
+## 管理已安装的 skills
+
+```bash
+# 查看已安装
+npx skills list
+npx skills list -g              # 全局 skills
+npx skills list -a opencode     # 按 agent 过滤
+
+# 更新
+npx skills update
+
+# 卸载
+npx skills remove darwin-skill
+npx skills remove --all
+```
+
+## 目录结构
+
+```
+dijk-skills/
+├── skills/               # Skill 定义
+│   ├── darwin-skill/
+│   │   ├── SKILL.md
+│   │   ├── references/
+│   │   ├── templates/
+│   │   └── test-prompts.json
+│   ├── grilling/
+│   │   └── SKILL.md
+│   ├── humanizer-zh/
+│   │   └── SKILL.md
+│   ├── i-have-adhd/
+│   │   ├── SKILL.md
+│   │   └── agents/
+│   └── skill-creator/
+│       ├── SKILL.md
+│       ├── references/
+│       └── scripts/
+├── agents/               # Agent 定义（预留）
+├── commands/             # 自定义命令（预留）
+├── rules/                # 规则文件（预留）
+├── scripts/              # 辅助脚本（预留）
+├── workflows/            # 工作流定义（预留）
+├── bin/
+│   └── install.js        # 自定义安装脚本
+├── package.json
+└── .npmignore
+```
+
+## 开发
+
+### 环境要求
+
+- Node.js >= 18
+
+### 本地开发
+
+```bash
+git clone <repo-url>
+cd dijk-skills
+
+# 新建 Skill
+mkdir -p skills/my-new-skill
+# 编写 SKILL.md，必须包含 YAML frontmatter：
+# ---
+# name: my-new-skill
+# description: 一句话描述这个 skill 做什么
+# ---
+
+# 预览安装结果（不实际安装）
+npx skills add . --list
+
+# 测试安装到临时目录
+npx skills add . -a opencode -g --skill my-new-skill -y
+
+# 或使用自定义脚本
+node bin/install.js --dir /tmp/test-dijk
+```
+
+### 添加新 Skill
+
+每个 Skill 是一个独立目录，至少包含 `SKILL.md`：
+
+```
+skills/my-skill/
+├── SKILL.md              # 必需：Skill 主文件（含 YAML frontmatter）
+├── references/           # 可选：参考资料
+├── scripts/              # 可选：辅助脚本
+├── templates/            # 可选：模板文件
+└── agents/               # 可选：关联 Agent
+```
+
+`SKILL.md` 格式：
+
+```markdown
+---
+name: my-skill
+description: 一句话描述这个 skill 的用途和触发条件
+---
+
+这里写 skill 的详细指令...
+```
+
+## 构建与发布
+
+### 打包预览
+
+```bash
+npm pack --dry-run
+```
+
+### 发布到 npm（可选）
+
+```bash
+npm publish
+```
+
+发布后可通过 `npx dijk-skills` 安装。但推荐使用 `npx skills add` 安装，无需发布到 npm。
+
+## 许可证
+
+MIT

package/bin/install.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+const { cpSync, existsSync, mkdirSync, readdirSync } = require('fs');
+const { dirname, join, resolve } = require('path');
+
+const SKIP = new Set(['__pycache__', '.gitkeep', '.DS_Store']);
+
+function copyFilter(src) {
+  const name = require('path').basename(src);
+  if (SKIP.has(name)) return false;
+  if (name.endsWith('.pyc') || name.endsWith('.pyo')) return false;
+  return true;
+}
+
+const args = process.argv.slice(2);
+
+// --help
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+dijk-skills - Install AI coding assistant skills, agents, and workflows
+
+Usage:
+  npx dijk-skills [options]
+  bunx dijk-skills [options]
+
+Options:
+  --dir <path>   Target directory (default: ~/.agents)
+  --help, -h     Show this help message
+
+Examples:
+  npx dijk-skills
+  npx dijk-skills --dir ~/.config/opencode
+  bunx dijk-skills --dir /custom/path
+`);
+  process.exit(0);
+}
+
+// Parse --dir
+let targetDir = join(process.env.HOME || process.env.USERPROFILE || '~', '.agents');
+for (let i = 0; i < args.length; i++) {
+  if ((args[i] === '--dir' || args[i] === '-d') && args[i + 1]) {
+    let dir = args[i + 1];
+    if (dir.startsWith('~')) {
+      dir = join(process.env.HOME || process.env.USERPROFILE || '~', dir.slice(1));
+    }
+    targetDir = resolve(dir);
+    i++;
+  }
+}
+
+const packageRoot = join(__dirname, '..');
+const dirs = ['agents', 'commands', 'rules', 'scripts', 'skills', 'workflows'];
+
+console.log(`\nInstalling dijk-skills to ${targetDir}\n`);
+
+// Create target directory
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+
+// Copy each directory
+const summary = [];
+for (const dir of dirs) {
+  const src = join(packageRoot, dir);
+  const dest = join(targetDir, dir);
+
+  if (!existsSync(src)) continue;
+
+  if (!existsSync(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+
+  const items = readdirSync(src).filter(f => f !== '.gitkeep');
+  if (items.length === 0) continue;
+
+  for (const item of items) {
+    const srcPath = join(src, item);
+    const destPath = join(dest, item);
+    cpSync(srcPath, destPath, { recursive: true, force: true, filter: copyFilter });
+  }
+
+  summary.push(`  ${dir}/ (${items.length} item${items.length > 1 ? 's' : ''})`);
+}
+
+if (summary.length > 0) {
+  console.log(summary.join('\n'));
+  console.log(`\n✓ Done\n`);
+} else {
+  console.log('Nothing to install.\n');
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "dijk-skills",
+  "version": "1.0.0",
+  "description": "Skills, agents, rules, and workflows for AI coding assistants",
+  "bin": {
+    "dijk-skills": "./bin/install.js"
+  },
+  "files": [
+    "bin/",
+    "agents/",
+    "commands/",
+    "rules/",
+    "scripts/",
+    "skills/",
+    "workflows/"
+  ],
+  "keywords": [
+    "ai",
+    "skills",
+    "agents",
+    "opencode",
+    "claude",
+    "coding-assistant"
+  ],
+  "scripts": {
+    "pack": "npm pack",
+    "prepublishOnly": "npm pack --dry-run",
+    "test:install": "rm -rf /tmp/test-dijk-install && node bin/install.js --dir /tmp/test-dijk-install && echo 'OK' && find /tmp/test-dijk-install -type f | wc -l"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}