prompt-finder

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Prompt File Finder

Prompt 文件查找器

Locate and resolve prompt files using the prompt-manager skill.

使用prompt-manager skill定位并解析prompt文件。

Setup

安装配置

All operations use prompt-manager for consistent git root detection:

bash

PLUGIN_ROOT=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)
PROMPT_MANAGER="$PLUGIN_ROOT/skills/prompt-manager/scripts/manager.py"

所有操作都使用prompt-manager实现一致的git根目录检测：

bash

PLUGIN_ROOT=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)
PROMPT_MANAGER="$PLUGIN_ROOT/skills/prompt-manager/scripts/manager.py"

When to Use This Skill

适用场景

User asks "find prompt 42" or "which prompt is about auth?"
User wants to "list available prompts" or "show prompts"
User asks "what's the latest prompt?" or "most recent prompt"
Before executing a prompt, to resolve the exact file path
User wants to search prompts by keyword

用户询问「查找编号42的prompt」或「哪个prompt是关于身份验证的？」
用户想要「列出可用prompt」或「展示所有prompt」
用户询问「最新的prompt是什么？」或「最近更新的prompt」
执行prompt前，用于解析确切的文件路径
用户想要按关键词搜索prompt

Core Operations

核心功能

List All Prompts

列出所有Prompt

bash

undefined

bash

undefined

List all prompts (active and completed)

列出所有prompt（活跃和已完成的）

python3 "$PROMPT_MANAGER" list

Output:

输出示例：

[ ] 006 - backup-server

[ ] 007 - deploy-k8s

[✓] 001 - initial-setup

[✓] 002 - add-authentication

As JSON

以JSON格式输出

python3 "$PROMPT_MANAGER" list --json

Active only

仅列出活跃的prompt

python3 "$PROMPT_MANAGER" list --active

Completed only

仅列出已完成的prompt

python3 "$PROMPT_MANAGER" list --completed

undefined

python3 "$PROMPT_MANAGER" list --completed

undefined

Find Prompt by Number

按编号查找Prompt

bash

undefined

bash

undefined

Returns path to prompt file

返回prompt文件的路径

python3 "$PROMPT_MANAGER" find 42

Output: /path/to/repo/prompts/042-my-prompt.md

输出示例: /path/to/repo/prompts/042-my-prompt.md

As JSON with full info

以JSON格式返回完整信息

python3 "$PROMPT_MANAGER" find 42 --json

{

"number": "042",

"name": "my-prompt",

"filename": "042-my-prompt.md",

"path": "/path/to/repo/prompts/042-my-prompt.md",

"status": "active"

}

undefined

undefined

Read Prompt Content

读取Prompt内容

bash

python3 "$PROMPT_MANAGER" read 42

bash

python3 "$PROMPT_MANAGER" read 42

Outputs the full content of the prompt

输出prompt的完整内容

undefined

undefined

Show Prompt Preview

展示Prompt预览

bash

undefined

bash

undefined

Read first 30 lines

读取前30行内容

python3 "$PROMPT_MANAGER" read 42 | head -30

undefined

python3 "$PROMPT_MANAGER" read 42 | head -30

undefined

Get Prompts Directory Info

获取Prompt目录信息

bash

python3 "$PROMPT_MANAGER" info

bash

python3 "$PROMPT_MANAGER" info

Repository root: /path/to/repo

输出示例：

Prompts directory: /path/to/repo/prompts

Repository root: /path/to/repo

Completed directory: /path/to/repo/prompts/completed

Prompts directory: /path/to/repo/prompts

Next number: 008

Completed directory: /path/to/repo/prompts/completed

Active prompts: 2

Next number: 008

Completed prompts: 5

Active prompts: 2

Total prompts: 7

Completed prompts: 5

As JSON

Total prompts: 7

—

以JSON格式输出

python3 "$PROMPT_MANAGER" info --json

undefined

python3 "$PROMPT_MANAGER" info --json

undefined

Find Prompt by Name/Keyword

按名称/关键词查找Prompt

bash

undefined

bash

undefined

List all and grep for keyword

列出所有prompt并通过grep匹配关键词

python3 "$PROMPT_MANAGER" list | grep -i "auth"

Or use JSON and jq

或者使用JSON和jq过滤

python3 "$PROMPT_MANAGER" list --json | jq '.[] | select(.name | contains("auth"))'

undefined

python3 "$PROMPT_MANAGER" list --json | jq '.[] | select(.name | contains("auth"))'

undefined

Search Prompt Contents

搜索Prompt内容

For content search, use Grep tool on the prompts directory:

bash

undefined

如果要搜索内容，可以在prompts目录下使用Grep工具：

bash

undefined

Get prompts directory

获取prompts目录路径

PROMPTS_DIR=$(python3 "$PROMPT_MANAGER" info --json | jq -r '.prompts_dir')

Search contents

搜索内容

grep -l -i "database" "$PROMPTS_DIR"/*.md 2>/dev/null


Or use the Grep tool:

Grep pattern="database" path="{prompts_dir}" glob="*.md"

undefined

grep -l -i "database" "$PROMPTS_DIR"/*.md 2>/dev/null


或者直接使用Grep工具：

Grep pattern="database" path="{prompts_dir}" glob="*.md"

undefined

Archive/Complete a Prompt

归档/标记完成Prompt

bash

python3 "$PROMPT_MANAGER" complete 42

bash

python3 "$PROMPT_MANAGER" complete 42

Output: Completed: /path/to/repo/prompts/completed/042-my-prompt.md

输出示例: Completed: /path/to/repo/prompts/completed/042-my-prompt.md

undefined

undefined

Resolution Examples

调用示例

bash

undefined

bash

undefined

Find prompt 6 (auto-pads to 006)

查找编号6的prompt（自动补零为006）

PROMPT_PATH=$(python3 "$PROMPT_MANAGER" find 6) if [ -n "$PROMPT_PATH" ]; then echo "Found: $PROMPT_PATH" # Read content CONTENT=$(python3 "$PROMPT_MANAGER" read 6) fi

PROMPT_PATH=$(python3 "$PROMPT_MANAGER" find 6) if [ -n "$PROMPT_PATH" ]; then echo "Found: $PROMPT_PATH" # 读取内容 CONTENT=$(python3 "$PROMPT_MANAGER" read 6) fi

Check if prompt exists

检查prompt是否存在

if python3 "$PROMPT_MANAGER" find 99 >/dev/null 2>&1; then echo "Prompt 99 exists" else echo "Prompt 99 not found" fi

undefined

if python3 "$PROMPT_MANAGER" find 99 >/dev/null 2>&1; then echo "Prompt 99 exists" else echo "Prompt 99 not found" fi

undefined

Error Handling

错误处理

prompt-manager returns exit code 1 and writes errors to stderr:

bash

$ python3 "$PROMPT_MANAGER" find 999
Error: Prompt 999 not found

$ python3 "$PROMPT_MANAGER" complete 6  # already completed
Error: Prompt 006 is already completed

prompt-manager会返回退出码1，并将错误信息输出到stderr：

bash

$ python3 "$PROMPT_MANAGER" find 999
Error: Prompt 999 not found

$ python3 "$PROMPT_MANAGER" complete 6  # 已经标记为完成的prompt
Error: Prompt 006 is already completed

Expected Directory Structure

要求的目录结构

{git_root}/prompts/
├── 006-backup-server.md
├── 007-deploy-k8s.md
├── ...
└── completed/
    ├── 001-initial-setup.md
    ├── 002-add-authentication.md
    └── ...

{git_root}/prompts/
├── 006-backup-server.md
├── 007-deploy-k8s.md
├── ...
└── completed/
    ├── 001-initial-setup.md
    ├── 002-add-authentication.md
    └── ...

Naming Convention

命名规范

Prompts follow the pattern:

NNN-descriptive-name.md

```
NNN
```
= Zero-padded number (001, 042, 123)
```
descriptive-name
```
= Kebab-case description (max 5 words)
```
.md
```
= Markdown extension

Prompt文件遵循以下命名模式：

NNN-descriptive-name.md

```
NNN
```
= 补零的三位数字（如001、042、123）
```
descriptive-name
```
= 短横线分隔的描述名称（最多5个单词）
```
.md
```
= Markdown扩展名

Legacy Compatibility

旧版本兼容

If prompt-manager is not available, fall back to direct file operations:

bash

undefined

如果prompt-manager不可用，可以降级为直接文件操作：

bash

undefined

Check if prompt-manager exists

检查prompt-manager是否存在

if [ ! -f "$PROMPT_MANAGER" ]; then # Fallback: direct file listing ls -1 ./prompts/*.md 2>/dev/null fi

undefined

if [ ! -f "$PROMPT_MANAGER" ]; then # 降级方案：直接列出文件 ls -1 ./prompts/*.md 2>/dev/null fi

undefined