| name | create-taskp-skill |
| description | taskp 用のスキル(SKILL.md)を対話的に設計・作成する。「taskp のスキルを作りたい」「.taskp/skills に追加したい」と言われたときに使う。 |
taskp スキル作成ガイド
ユーザーの要望をヒアリングし、taskp の SKILL.md 仕様に準拠したスキルファイルを作成する。
仕様の要点
ファイル構造
.taskp/skills/<skill-name>/
└── SKILL.md
name フィールドとディレクトリ名を一致させること
フロントマター(YAML)
---
name: <skill-name>
description: <説明>
mode: template | agent
inputs: []
model: provider/model
tools: [bash, read, write]
context: []
timeout: 30000
actions:
action-name:
description: <説明>
mode: agent
model: provider/model
inputs: []
tools: []
context: []
timeout: 30000
---
Input 定義
inputs:
- name: varname
type: text
message: "質問文"
default: "デフォルト値"
choices: [a, b, c]
required: true
validate: "^[a-z]+$"
Agent ツール
agent モードで使用できるツール一覧:
| ツール | 説明 | デフォルト |
|---|
bash | シェルコマンドを実行 | ✅ |
read | ファイル内容を読み取り | ✅ |
write | ファイルに書き込み | ✅ |
edit | ファイル内の特定文字列を置換(完全一致が1箇所のみ必要) | — |
glob | glob パターンでファイルを検索 | — |
grep | ファイル内容をパターン検索(正規表現対応) | — |
fetch | URL からテキストコンテンツを取得(http/https のみ) | — |
ask_user | 実行中にユーザーに質問 | — |
taskp_run | 他の template モードスキルを呼び出し | — |
tools 未指定時は bash, read, write がデフォルトで有効。
taskp_run の制約
- template モードのスキルのみ呼び出し可能(agent のネストは不可)
- 再帰呼び出しは検出・ブロック
- 最大ネスト深度: 3
Context 定義
context:
- type: file
path: "src/{{target}}"
- type: glob
pattern: "src/**/*.ts"
- type: command
run: "git diff --cached"
- type: url
url: "https://example.com/docs"
- type: image
path: "docs/diagram.png"
画像コンテキスト
type: image は画像ファイルをバイナリ読み込みし、マルチモーダルコンテンツとして LLM に送信する。
対応フォーマット: PNG, JPEG, GIF, WebP(SVG, BMP 等は非対応でエラー)
変数展開
- 構文:
{{variable_name}}
- 変数パターン:
\w+(英数字とアンダースコアのみ)
- 未定義変数があるとエラーになる
条件ブロック
{{#if var}}...{{/if}} および {{#if var}}...{{else}}...{{/if}} が使える。
{{#if confirm}}
確認済みの処理を実行します。
{{else}}
スキップしました。
{{/if}}
truthy / falsy 判定:
- falsy: 空文字
"" と "false"
- truthy: それ以外すべて(
"true", "hello", "0" 等)
制約:
- ネスト不可(
{{#if}} の中に {{#if}} を書くとエラー)
- 閉じタグ
{{/if}} 必須(なければエラー)
- 選択されなかった分岐内の未定義変数はエラーにならない
予約変数(inputs で定義せずに使える)
| 変数 | 説明 |
|---|
{{__cwd__}} | 現在の作業ディレクトリ |
{{__skill_dir__}} | スキルファイルのディレクトリパス |
{{__date__}} | 実行日(YYYY-MM-DD) |
{{__timestamp__}} | 実行タイムスタンプ(ISO 8601) |
マルチアクション
1つのスキルに複数のアクションを定義できる。
actions:
add:
description: タスクを追加する
inputs:
- name: title
type: text
message: "タスク名は?"
list:
description: タスク一覧を表示する
delete:
description: タスクを削除する
mode: agent
tools: [bash, read, grep]
inputs:
- name: id
type: text
message: "タスクIDは?"
actions が定義されている場合、スキルレベルの inputs は無視される
- 各アクションは
mode, model, inputs, tools, context, timeout を個別に上書き可能(未指定はスキルレベルを継承)
- inputs は継承されない(各アクションで独自に定義)
- 本文中の
## action:<name> セクション(H2 固定)でアクションの実行手順を定義する
- 実行:
taskp run skill:action
カスタムシステムプロンプト
agent モードで使用されるシステムプロンプトを SYSTEM.md でカスタマイズできる。
| 場所 | スコープ |
|---|
.taskp/SYSTEM.md | プロジェクトローカル(優先) |
~/.taskp/SYSTEM.md | グローバル |
SYSTEM.md が存在する場合、その内容がデフォルトのシステムプロンプトの代わりに使用される。利用可能なツール一覧と環境情報は自動的に付与される。
実行モードの選び方
| モード | 用途 | LLM |
|---|
| template | 確定的な手順の自動化(ビルド、デプロイ等) | 不要 |
| agent | 判断を伴うタスク(レビュー、生成、分析等) | 必要 |
template モード
- マークダウン内の
```bash コードブロックを上から順に抽出・実行
- 変数展開後に execa で実行
- 非ゼロ終了コードで中断
agent モード
- マークダウン全体を LLM のプロンプトとして送信
- LLM が tools を呼び出して自律実行
- LLM が完了と判断するまでループ
- model 指定:
provider/model 形式(例: anthropic/claude-sonnet-4-20250514)
- model 解決順: CLI オプション > スキルの frontmatter > config.toml のデフォルト
作成手順
- ヒアリング: ユーザーにスキルの目的・用途を聞く
- モード判定: 確定的な手順か、判断が必要かで template / agent を決める
- 入力設計: 必要なパラメータを inputs として定義する
- コンテキスト設計: 自動取得すべき情報があれば context を定義する(画像を含むマルチモーダルタスクには
type: image を使う)
- ツール選定(agent モード): デフォルトの bash/read/write に加え、必要なツールを選択する
- アクション設計: 関連する複数の操作がある場合は
actions でまとめる
- 本文作成: 手順書(template)またはプロンプト(agent)を書く
- ファイル出力:
.taskp/skills/<name>/SKILL.md に書き出す
注意事項・よくある落とし穴
- 変数名は
\w+ のみ: ハイフンやドットは使えない(my_var は OK、my-var は NG)
{{#if}} はネスト不可: {{#if a}}{{#if b}}...{{/if}}{{/if}} はエラーになる。フラットに並べること
{{/if}} の閉じ忘れはエラー: サイレントに壊れることはない
- confirm 型は
{{#if}} と組み合わせる: {{#if confirmed}}実行{{else}}スキップ{{/if}}
- required: false の空入力も
{{#if}} で判定可能: 空文字は falsy になる
"0" は truthy: falsy は "" と "false" のみ
- context 内のパスも変数展開される:
path: "src/{{target}}" のように動的パスが使える
- name とディレクトリ名を一致させる: 不一致だとスキルが見つからない
- template モードでは bash コードブロックのみ実行される: 他の言語のコードブロックは無視される
- スキルディレクトリにヘルパースクリプトを置ける:
{{__skill_dir__}}/script.sh で参照可能
- 画像コンテキストは対応フォーマットのみ: PNG, JPEG, GIF, WebP 以外はエラーになる
- actions 定義時は inputs が無視される: 各アクションで個別に定義すること