Planning With Files Zht

# 檢查 task_plan.md 中所有階段是否完成
# 始終以退出碼 0 結束 — 使用標準輸出回報狀態
# 由 Stop 鉤子呼叫以回報任務完成狀態

param(
    [string]$PlanFile = "task_plan.md"
)

if (-not (Test-Path $PlanFile)) {
    Write-Host '[planning-with-files] 未找到 task_plan.md — 沒有進行中的規劃會話。'
    exit 0
}

# 讀取檔案內容
$content = Get-Content $PlanFile -Raw

# 計算階段總數
$TOTAL = ([regex]::Matches($content, "### 階段")).Count

# 先檢查 **狀態：** 格式
$COMPLETE = ([regex]::Matches($content, "\*\*狀態：\*\* complete")).Count
$IN_PROGRESS = ([regex]::Matches($content, "\*\*狀態：\*\* in_progress")).Count
$PENDING = ([regex]::Matches($content, "\*\*狀態：\*\* pending")).Count

# 備用：如果未找到 **狀態：** 則檢查 [complete] 行內格式
if ($COMPLETE -eq 0 -and $IN_PROGRESS -eq 0 -and $PENDING -eq 0) {
    $COMPLETE = ([regex]::Matches($content, "\[complete\]")).Count
    $IN_PROGRESS = ([regex]::Matches($content, "\[in_progress\]")).Count
    $PENDING = ([regex]::Matches($content, "\[pending\]")).Count
}

# 回報狀態 — 始終以退出碼 0 結束，未完成的任務是正常狀態
if ($COMPLETE -eq $TOTAL -and $TOTAL -gt 0) {
    Write-Host ('[planning-with-files] 所有階段已完成（' + $COMPLETE + '/' + $TOTAL + '）。如果使用者有額外工作，請在開始前於 task_plan.md 中新增階段。')
} else {
    Write-Host ('[planning-with-files] 任務進行中（' + $COMPLETE + '/' + $TOTAL + ' 個階段已完成）。停止前請更新 progress.md。')
    if ($IN_PROGRESS -gt 0) {
        Write-Host ('[planning-with-files] ' + $IN_PROGRESS + ' 個階段仍在進行中。')
    }
    if ($PENDING -gt 0) {
        Write-Host ('[planning-with-files] ' + $PENDING + ' 個階段待處理。')
    }
}
exit 0


#!/usr/bin/env bash
# 檢查 task_plan.md 中所有階段是否完成
# 始終以退出碼 0 結束 — 使用標準輸出回報狀態
# 由 Stop 鉤子呼叫以回報任務完成狀態

PLAN_FILE="${1:-task_plan.md}"

if [ ! -f "$PLAN_FILE" ]; then
    echo "[planning-with-files] 未找到 task_plan.md — 沒有進行中的規劃會話。"
    exit 0
fi

# 計算階段總數
TOTAL=$(grep -c "### 階段" "$PLAN_FILE" || true)

# 先檢查 **狀態：** 格式
COMPLETE=$(grep -cF "**狀態：** complete" "$PLAN_FILE" || true)
IN_PROGRESS=$(grep -cF "**狀態：** in_progress" "$PLAN_FILE" || true)
PENDING=$(grep -cF "**狀態：** pending" "$PLAN_FILE" || true)

# 備用：如果未找到 **狀態：** 則檢查 [complete] 行內格式
if [ "$COMPLETE" -eq 0 ] && [ "$IN_PROGRESS" -eq 0 ] && [ "$PENDING" -eq 0 ]; then
    COMPLETE=$(grep -c "\[complete\]" "$PLAN_FILE" || true)
    IN_PROGRESS=$(grep -c "\[in_progress\]" "$PLAN_FILE" || true)
    PENDING=$(grep -c "\[pending\]" "$PLAN_FILE" || true)
fi

# 預設為 0（如果為空）
: "${TOTAL:=0}"
: "${COMPLETE:=0}"
: "${IN_PROGRESS:=0}"
: "${PENDING:=0}"

# 回報狀態（始終以退出碼 0 結束 — 未完成的任務是正常狀態）
if [ "$COMPLETE" -eq "$TOTAL" ] && [ "$TOTAL" -gt 0 ]; then
    echo "[planning-with-files] 所有階段已完成（$COMPLETE/$TOTAL）。如果使用者有額外工作，請在開始前於 task_plan.md 中新增階段。"
else
    echo "[planning-with-files] 任務進行中（$COMPLETE/$TOTAL 個階段已完成）。停止前請更新 progress.md。"
    if [ "$IN_PROGRESS" -gt 0 ]; then
        echo "[planning-with-files] $IN_PROGRESS 個階段仍在進行中。"
    fi
    if [ "$PENDING" -gt 0 ]; then
        echo "[planning-with-files] $PENDING 個階段待處理。"
    fi
fi
exit 0


# 初始化新會話的規劃檔案
# 用法：.\init-session.ps1 [專案名稱]

param(
    [string]$ProjectName = "project"
)

$DATE = Get-Date -Format "yyyy-MM-dd"

Write-Host "正在初始化規劃檔案：$ProjectName"

# 如果 task_plan.md 不存在則建立
if (-not (Test-Path "task_plan.md")) {
    @"
# 任務計畫：[簡要描述]

## 目標
[用一句話描述最終狀態]

## 目前階段
階段 1

## 各階段

### 階段 1：需求與發現
- [ ] 理解使用者意圖
- [ ] 確定約束條件和需求
- [ ] 將發現記錄到 findings.md
- **狀態：** in_progress

### 階段 2：規劃與結構
- [ ] 確定技術方案
- [ ] 如有需要建立專案結構
- **狀態：** pending

### 階段 3：實作
- [ ] 按計畫逐步執行
- [ ] 先將程式碼寫入檔案再執行
- **狀態：** pending

### 階段 4：測試與驗證
- [ ] 驗證所有需求已滿足
- [ ] 將測試結果記錄到 progress.md
- **狀態：** pending

### 階段 5：交付
- [ ] 檢查所有輸出檔案
- [ ] 交付給使用者
- **狀態：** pending

## 已做決策
| 決策 | 理由 |
|------|------|

## 遇到的錯誤
| 錯誤 | 解決方案 |
|------|---------|
"@ | Out-File -FilePath "task_plan.md" -Encoding UTF8
    Write-Host "已建立 task_plan.md"
} else {
    Write-Host "task_plan.md 已存在，跳過"
}

# 如果 findings.md 不存在則建立
if (-not (Test-Path "findings.md")) {
    @"
# 發現與決策

## 需求
-

## 研究發現
-

## 技術決策
| 決策 | 理由 |
|------|------|

## 遇到的問題
| 問題 | 解決方案 |
|------|---------|

## 資源
-
"@ | Out-File -FilePath "findings.md" -Encoding UTF8
    Write-Host "已建立 findings.md"
} else {
    W