AgentSkillsCN

os-tk-setup

验证前置条件、安装所需工具，并配置 os-tk-pi 工作流。

SKILL.md
--- frontmatter
name: os-tk-setup
description: Verify prerequisites, install tools, and configure os-tk-pi workflow.

/os-tk-setup

Purpose

  • •Verify prerequisites and install status
  • •Install missing tools interactively
  • •Configure workflow settings (interactive wizard)
  • •Ensure .os-tk/ state/log files exist

Resolve skill dir (for scripts)

bash
SKILL_DIR=".pi/skills/os-tk-setup"
if [[ ! -d "$SKILL_DIR" ]]; then SKILL_DIR="pi/skills/os-tk-setup"; fi

Commands

bash
/os-tk-setup           # Full wizard (check + install + configure)
/os-tk-setup --check   # Only check prerequisites
/os-tk-setup --wizard  # Only run configuration wizard

Steps

1) Check prerequisites (warn-only)

  • •bash "$SKILL_DIR/scripts/check-prereqs.sh"

Checks for:

  • •OpenSpec CLI
  • •ticket (tk)
  • •ripgrep (rg)
  • •fd
  • •uv (for Serena MCP)
  • •ast-grep
  • •subagent extension (pi-async-subagents)
  • •MCP servers (if enabled)

2) Install missing tools (optional, interactive)

If the user wants to install missing prerequisites:

  • •bash "$SKILL_DIR/scripts/install-prereqs.sh"

3) Run configuration wizard

If the user wants to configure settings:

Option A: Via Python script

bash
python3 "$SKILL_DIR/scripts/setup-wizard.py"

Option B: Via skill

bash
/os-tk-config wizard

4) Ensure subagent is installed (REQUIRED)

Installs/updates pi-async-subagents at:

  • •~/.pi/agent/extensions/subagent

Run:

bash
bash "$SKILL_DIR/scripts/ensure-subagent.sh"

Related scripts:

  • •bash "$SKILL_DIR/scripts/install-subagent.sh" (interactive)
  • •bash "$SKILL_DIR/scripts/ensure-subagent.sh" (non-interactive)

5) Ensure pi-prompt-template-model is installed (RECOMMENDED)

This enables per-command frontmatter routing for:

  • •model / thinking
  • •skill injection

Install location:

  • •~/.pi/agent/extensions/pi-prompt-template-model

Run (non-interactive):

bash
bash "$SKILL_DIR/scripts/ensure-prompt-template-model.sh"

Interactive:

bash
bash "$SKILL_DIR/scripts/install-prompt-template-model.sh"

6) Ensure pi-mcp-adapter is installed (HIGHLY RECOMMENDED for MCP users)

Required for MCP servers to work — MCP servers (context7, exa, grep_app, serena, zai-*) will not function without this adapter.

Install location:

  • •~/.pi/agent/extensions/pi-mcp-adapter

Run (non-interactive):

bash
bash "$SKILL_DIR/scripts/ensure-mcp-adapter.sh"

Interactive:

bash
bash "$SKILL_DIR/scripts/install-mcp-adapter.sh"

Note: After installing the adapter, configure MCP servers:

  • •Enable MCP: Set "mcp.enabled": true in .os-tk/config.json
  • •Add API keys: Edit .pi/mcp.json with your API keys

Quick alternative: Install all extensions at once:

bash
bash "$SKILL_DIR/scripts/ensure-all-extensions.sh"

7) Other optional installers

  • •Pre-commit: bash "$SKILL_DIR/scripts/setup-precommit.sh"
  • •OpenSpec init: bash "$SKILL_DIR/scripts/ensure-openspec-init.sh"
  • •State files: bash "$SKILL_DIR/scripts/ensure-state-files.sh"
  • •Project MCP config: bash "$SKILL_DIR/scripts/ensure-mcp-config.sh"

Apply config to prompt/agent frontmatter (recommended)

Run:

  • •bash "$SKILL_DIR/scripts/apply-config.sh"

This updates:

  • •.pi/prompts/os-tk-*.md (model/thinking/skill/restore) for pi-prompt-template-model
  • •.pi/agents/os-tk-*.md (model) for pi-async-subagents

Report status

After checks and optional installation:

  • •Summarize what's installed vs missing
  • •Suggest /os-tk-sync after editing .os-tk/config.json
  • •Suggest /os-tk-config wizard
  • •Suggest /os-tk-proposal "<request>" to start