创建

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

堆栈选择

任务 · 堆栈 · 原因文件、glob、正则表达式、JSON 管道 · bash · 如果 < 50 行,则最快 任何复杂的、类型、JSON 处理 · TypeScript (bun) · 默认数据密集型操作、ML 库 · Python (uv) · 库访问

规则

破坏性 = 空运行默认开启。必须使用显式的--no-dry-run来执行。登录到~/.claude/logs/[scriptname].jsonl以获取相关的审核跟踪(文件修改、网络获取、API 调用)。写入后的chmod +x — 必须设置执行位。 --help 是强制性的——即使没有参数也显示它。切勿对凭据进行硬编码 - 从~/.claude/.env读取。

版本历史

v3.0 (2026-05-02):首次公开发布。资料来源:carlheath/ogmios — 由 TomeVault 分发。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# CreateCLI

**Role:** quick CLI authoring for `~/.claude/scripts/`.

## Stack choice

| Task | Stack | Reason |
|------|-------|--------|
| Files, glob, regex, JSON piping | bash | Fastest if < 50 lines |
| Anything complex, types, JSON handling | TypeScript (bun) | Default |
| Data-heavy operations, ML libraries | Python (uv) | Library access |

## Anatomy (TypeScript default)

```typescript
#!/usr/bin/env bun
/**
 * [scriptname] — [short description]
 *
 * Usage: [scriptname] [args] [flags]
 *
 * Created: 2026-MM-DD via createcli skill
 */

import { parseArgs } from 'util';

const { values, positionals } = parseArgs({
  args: process.argv.slice(2),
  options: {
    'dry-run': { type: 'boolean', default: true },  // destructive: default ON
    'verbose': { type: 'boolean', short: 'v' },
    'help': { type: 'boolean', short: 'h' },
  },
  allowPositionals: true,
});

if (values.help) {
  console.log(`[scriptname] — [description]

Usage:
  [scriptname] [args]

Flags:
  --dry-run     Show what would happen without doing it (default: ON for destructive)
  --verbose     More detailed output
  --help        This text
`);
  process.exit(0);
}

// ... core logic
```

## Anatomy (bash)

```bash
#!/usr/bin/env bash
set -euo pipefail

usage() {
  cat <<EOF
[scriptname] — [description]

Usage: [scriptname] [args]

Flags:
  -n, --dry-run    Show what would happen
  -v, --verbose    More detailed output
  -h, --help       This text
EOF
}

DRY_RUN=true  # destructive default
while [[ $# -gt 0 ]]; do
  case "$1" in
    -n|--dry-run) DRY_RUN=true; shift ;;
    --no-dry-run) DRY_RUN=false; shift ;;
    -v|--verbose) VERBOSE=true; shift ;;
    -h|--help) usage; exit 0 ;;
    *) ARGS+=("$1"); shift ;;
  esac
done

# core logic
```

## Rules

1. **Destructive = dry-run default ON.** Must use explicit `--no-dry-run` to execute.
2. **Log to `~/.claude/logs/[scriptname].jsonl`** for an audit trail when relevant (file-modifying, network-fetching, API calls).
3. **`chmod +x`** after Write — exec bit must be set.
4. **`--help` is mandatory** — show it even when no args.
5. **Never hardcode credentials** — read from `~/.claude/.env`.
6. **Output in markdown** if the script produces a text report (not tabular).

## Workflow

```
1. The user describes: "I need a script that [X]"
2. Choose stack (bash/TS/Python) per the table above
3. Create the anatomy template
4. Implement core logic
5. chmod +x ~/.claude/scripts/[scriptname]
6. Test: ./scripts/[scriptname] --help
7. Test: ./scripts/[scriptname] --dry-run [args]
8. Report to user: what the script does + examples
```

## Version history

- v3.0 (2026-05-02): initial public release.

---
> Source: [carlheath/ogmios](https://github.com/carlheath/ogmios) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。