Agent skill

creative-status

Quellcode ansehen: miles990/creative-toolkit

#116Globales Ranking · von 116 SkillsSafe

Installation

npx skills add miles990/creative-toolkit --skill creative-status

1

Installationen

EU-hosted inference API

Power your AI agent skills with open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

MiniMax

MiniMax M3

$0.50 / $1.90

per M tokens

Z.ai

GLM 5.3 Flash

$0.20 / $0.60

per M tokens

MoonshotAI

Kimi K3

$4.00 / $18.00

per M tokens

DeepSeek

DeepSeek V4.1 Flash

$0.40 / $1.42

per M tokens

創意專案狀態總覽 Skill

展示創意專案的完整狀態、進度追蹤、品質分析與健康度檢查。支援多種創意領域(小說、劇本、遊戲等)。

指令格式

/creative-status [選項]

選項

  • 無選項: 顯示總體狀態概覽
  • --chapters: 顯示單元明細列表(章節、關卡、場景等)
  • --quality: 顯示品質詳細分析
  • --memory: 顯示記憶系統健康度
  • --health: 執行文件系統健康檢查
  • --all: 顯示完整報告

前置步驟(Domain 載入)

  1. Read .creative/config.yaml → 取得 domain 值
  2. 如果 config 不存在 → 提示 "非創意專案目錄,請執行 /creative-init"
  3. 根據 Skill header 中的 Base directory 計算 PLUGIN_ROOT
    • PLUGIN_ROOT = Base directory 去掉 /skills/creative-status 部分
  4. 設定 DOMAIN_DIR = $PLUGIN_ROOT/shared/domains/{domain}/
  5. Read $DOMAIN_DIR/domain.yaml → 取得 paths 和 quality 定義
  6. Read $DOMAIN_DIR/status-guide.md → 取得領域專用狀態顯示指引
  7. 依指引執行下方工作流

執行流程

1. 環境檢查

# 確認在專案根目錄
if [ ! -d ".creative" ]; then
  echo "錯誤: 非創意專案目錄"
  exit 1
fi

2. 數據收集

讀取核心文件

Read .creative/status.json
Read .creative/config.yaml
Read {domain.yaml 中 paths.planning.layers.L1 路徑}

統計文件數量

// 根據 domain.yaml 的 paths.planning.layers 定義統計
for (const [layerName, layerPath] of Object.entries(domain.paths.planning.layers)) {
  const pattern = layerPath.replace("{id}", "*")
  const count = glob(pattern).length
  stats[layerName] = count
}

// 統計已完成單元(草稿)
const draftPattern = domain.paths.output.drafts.final.replace("{id}", "*")
const draftCount = glob(draftPattern).length

// 統計品質報告
const qaPattern = domain.paths.quality.reports.replace("{id}", "*")
const qaCount = glob(qaPattern).length

統計內容量度(字數、時長等)

// 根據 domain.yaml 的 metrics 定義統計
const metricType = domain.metrics.primary // 例如 "word_count", "duration", "complexity"

// 總量
const draftFiles = glob(domain.paths.output.drafts.final.replace("{id}", "*"))
let totalMetric = 0
for (const file of draftFiles) {
  totalMetric += calculateMetric(file, metricType)
}

// 已發布量
const publishedFiles = glob(domain.paths.output.published.replace("{id}", "*"))
let publishedMetric = 0
for (const file of publishedFiles) {
  publishedMetric += calculateMetric(file, metricType)
}

3. 基礎狀態輸出(預設)

根據 domain-specific guide 中定義的格式輸出:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  {metadata.title}
  {metadata.author}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 總體進度
  {進度條} {完成百分比}%

  {單元名稱}進度: {已完成數} / {總數} {單位}
  {量度名稱}: {已完成量} / {目標量}

📝 規劃狀態
  {根據 domain.paths.planning.layers 列出每一層的完成情況}

✍️  {執行階段名稱}狀態
  {根據 domain.paths.output 列出各階段完成情況}

🎯 品質保障
  {根據 domain.quality 定義列出品質統計}

⏭️  下一步建議
  {根據 guide 中定義的建議邏輯生成}

建議生成邏輯

// 根據 domain.paths.planning.layers 的完成度判斷
const layers = Object.keys(domain.paths.planning.layers)

for (const layer of layers) {
  if (!isLayerComplete(layer)) {
    return guide.suggestions.incomplete_layer(layer)
  }
}

// 如果規劃完成,檢查執行進度
if (draftCount < totalUnits) {
  return guide.suggestions.continue_execution(nextUnit)
}

// 如果執行完成,檢查品質
if (qaCount < draftCount) {
  return guide.suggestions.run_quality_check()
}

// 如果有未解決問題
if (unresolvedIssues > 0) {
  return guide.suggestions.fix_issues()
}

// 全部完成
return guide.suggestions.ready_to_publish()

4. 單元明細(--chapters)

根據 domain-specific guide 中定義的格式輸出詳細表格。

// 讀取所有單元狀態
const units = loadAllUnits(domain)

// 根據 guide 中定義的表格格式輸出
for (const unit of units) {
  const planningStatus = checkPlanningStatus(unit, domain)
  const executionStatus = checkExecutionStatus(unit, domain)
  const qualityStatus = checkQualityStatus(unit, domain)
  const metric = calculateUnitMetric(unit, domain)
  const score = getQualityScore(unit)

  printUnitRow(unit.id, unit.title, planningStatus, executionStatus, qualityStatus, metric, score)
}

5. 品質詳情(--quality)

根據 domain-specific guide 中定義的格式輸出品質分析。

// 讀取所有品質報告
const reports = glob(domain.paths.quality.reports.replace("{id}", "*"))
const scores = []
const issues = {}

for (const reportPath of reports) {
  const report = readQualityReport(reportPath, domain)
  scores.push(report.overall_score)

  // 統計各類問題
  for (const issue of report.issues) {
    issues[issue.type] = (issues[issue.type] || 0) + 1
  }
}

// 計算各維度平均
const dimensions = domain.quality.dimensions
const dimensionScores = {}
for (const dim of dimensions) {
  dimensionScores[dim.name] = calculateAverageDimension(reports, dim.name)
}

// 根據 guide 輸出品質趨勢圖、維度分數、問題統計

6. 記憶健康度(--memory)

根據 domain-specific guide 中定義的格式輸出記憶系統狀態。

// 統計知識庫規模
const knowledgeStats = {}
for (const [category, path] of Object.entries(domain.paths.knowledge)) {
  knowledgeStats[category] = glob(path + "/*.md").length
}

// 檢查覆蓋率
const coverageStats = checkKnowledgeCoverage(domain)

// 檢查更新狀態
const lastUpdate = getLastUpdateTime(domain.paths.knowledge)
const needsUpdate = checkNeedsUpdate(domain)

// 根據 guide 輸出記憶健康度報告

7. 健康檢查(--health)

根據 domain-specific guide 中定義的檢查項目執行系統健康檢查。

// 檢查目錄結構完整性
const requiredDirs = extractAllPaths(domain.paths)
const missingDirs = []
for (const dir of requiredDirs) {
  if (!exists(dir)) {
    missingDirs.push(dir)
  }
}

// 檢查必要文件存在
const requiredFiles = [
  ".creative/status.json",
  ".creative/config.yaml",
  domain.paths.planning.layers.L1
]
const missingFiles = checkMissingFiles(requiredFiles)

// 檢查孤立文件
const orphanedFiles = findOrphanedFiles(domain)

// 檢查命名規範
const namingIssues = checkNamingConventions(domain)

// 根據 guide 輸出健康檢查報告

錯誤處理

若 .creative/ 不存在:
  "錯誤: 當前目錄不是創意專案"
  "提示: 執行 /creative-init 初始化專案"

若 config.yaml 缺少 domain:
  "錯誤: 配置文件缺少 domain 定義"

若 domain.yaml 不存在:
  "錯誤: 不支援的 domain: {domain}"
  "支援的 domain: {列出 shared/domains/ 下的目錄}"

若 status-guide.md 不存在:
  "警告: 缺少領域專用指引,使用通用格式"

若 status.json 損壞:
  "警告: 狀態文件損壞,嘗試重建"

若無任何數據:
  "提示: 專案尚未初始化,執行 /creative-init 開始"

使用範例

範例 1: 快速查看狀態

User: /creative-status

範例 2: 查看單元明細

User: /creative-status --chapters

範例 3: 品質分析

User: /creative-status --quality

範例 4: 完整報告

User: /creative-status --all

So verwenden Sie diesen Skill

  1. 1

    Install creative-status by running npx skills add miles990/creative-toolkit --skill creative-status in your project directory. Führen Sie den obigen Installationsbefehl in Ihrem Projektverzeichnis aus. Die Skill-Datei wird von GitHub heruntergeladen und in Ihrem Projekt platziert.

  2. 2

    Keine Konfiguration erforderlich. Ihr KI-Agent (Claude Code, Cursor, Windsurf usw.) erkennt installierte Skills automatisch und nutzt sie als Kontext bei der Code-Generierung.

  3. 3

    Der Skill verbessert das Verständnis Ihres Agenten für creative-status, und hilft ihm, etablierte Muster zu befolgen, häufige Fehler zu vermeiden und produktionsreifen Code zu erzeugen.

Was Sie erhalten

Skills sind Klartext-Anweisungsdateien — kein ausführbarer Code. Sie kodieren Expertenwissen über Frameworks, Sprachen oder Tools, das Ihr KI-Agent liest, um seine Ausgabe zu verbessern. Das bedeutet null Laufzeit-Overhead, keine Abhängigkeitskonflikte und volle Transparenz: Sie können jede Anweisung vor der Installation lesen und prüfen.

Kompatibilität

Dieser Skill funktioniert mit jedem KI-Coding-Agenten, der das skills.sh-Format unterstützt, einschließlich Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider und anderen Tools, die projektbezogene Kontextdateien lesen. Skills sind auf Transportebene framework-agnostisch — der Inhalt bestimmt, für welche Sprache oder welches Framework er gilt.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.