OthmanAdi/planning-with-files / skills/i18n/planning-with-files-zh
planning-with-files-zh
Verified用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续,绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词:任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目
scripts/check-complete.sh
View on GitHub#!/usr/bin/env bash
# 检查 task_plan.md 中所有阶段是否完成
# 始终以退出码 0 结束 — 使用标准输出报告状态
# 由 Stop 钩子调用以报告任务完成状态
# Explicit creation validation; the existing localized advisory path stays unchanged.
VALIDATE=0
VALIDATION_PLAN=""
for _arg in "$@"; do
case "$_arg" in
--validate) VALIDATE=1 ;;
*) [ -z "$VALIDATION_PLAN" ] && VALIDATION_PLAN="$_arg" ;;
esac
done
if [ "$VALIDATE" -eq 1 ]; then
PLAN_FILE="${VALIDATION_PLAN:-task_plan.md}"
[ -f "$PLAN_FILE" ] || { echo "[planning-with-files] Plan format invalid: task_plan.md was not found." >&2; exit 1; }
fi
# issue #195: per-invocation opt-out (PLANNING_DISABLED=1) for one-shot/CI
# sessions that share a cwd with a plan but never opted into it.
[ "${PLANNING_DISABLED:-}" = "1" ] && [ "$VALIDATE" -eq 0 ] && exit 0
[ "$VALIDATE" -ne 0 ] || PLAN_FILE="${1:-task_plan.md}"
if [ "$VALIDATE" -eq 0 ] && [ ! -f "$PLAN_FILE" ]; then
# Automatic gate checks have nothing to report without a plan (header:
# "plans stay silent in --gate mode"); the explicit report keeps its notice.
[ "$GATE" -eq 1 ] && exit 0
echo "[planning-with-files] 未找到 task_plan.md — 没有进行中的规划会话。"
exit 0
fi
# Count native statuses inside real phases, excluding fenced examples (#377).
PLAN_COUNTS=$(LC_ALL=C awk '
function finish_phase() {
if (in_phase) {
if (status_count != 1) invalid = 1
else {
if (phase_status != "in_progress") counts[phase_status]++
}
if (has_active_status) {
counts["in_progress"]++
if (active_heading == "") active_heading = heading
}
}
in_phase = 0; status_count = 0; phase_status = ""; has_active_status = 0
}
function fenced(line, trimmed, marker, run) {
trimmed = line; sub(/^ ? ? ?/, "", trimmed)
if (line ~ /^ ? ? ?```/ || line ~ /^ ? ? ?~~~/) {
marker = substr(trimmed, 1, 1); run = 0
while (substr(trimmed, run + 1, 1) == marker) run++
if (fence == "" && marker == "`" && index(substr(trimmed, run + 1), "`")) return 0
if (fence == "") { fence = marker; fence_length = run }
else if (marker == fence && run >= fence_length && substr(trimmed, run + 1) ~ /^[ \t]*$/) fence = ""
return 1
}
return fence != ""
}
function read_status(line, token, boundary) {
while (match(line, /\*\*状态:\*\*[ \t]+(pending|in_progress|complete)([^A-Za-z0-9_]|$)|\[(pending|in_progress|complete)\]/)) {
token = substr(line, RSTART, RLENGTH)
boundary = substr(token, 1, 2) == "**" && token ~ /[^A-Za-z0-9_]$/
sub(/^\*\*状态:\*\*[ \t]+|^\[/, "", token)
sub(/[^a-z_].*$/, "", token)
status_count++; phase_status = token
if (token == "in_progress") has_active_status = 1
line = substr(line, RSTART + RLENGTH - boundary)
}
}
NR == 1 { sub(/^\357\273\277/, "") }
{ sub(/\r$/, "") }
fenced($0) || /^ ? ? ?>/ { next }
/^ ? ? ?### 阶段([0-9:]|-[0-9])/ { finish_phase(); malformed_heading = 1; next }
/^ ? ? ?### 阶段([ \t]|$)/ {
finish_phase(); total++; in_phase = 1; heading = $0
}
!/^ ? ? ?### 阶段([ \t]|$)/ && /^ ? ? ?(###|##|#)([ \t]|$)/ { finish_phase() }
in_phase { read_status($0) }
END {
finish_phase()
printf "%d %d %d %d %d %d\n%s\n", total, counts["complete"], counts["in_progress"], counts["pending"], invalid, (fence != "" || malformed_heading), active_heading
}
' 2>/dev/null < "$PLAN_FILE") || PLAN_COUNTS="0 0 0 0 0 1"
read -r TOTAL COMPLETE IN_PROGRESS PENDING INVALID UNKNOWN <<EOF
$PLAN_COUNTS
EOF
if [ "$VALIDATE" -eq 1 ]; then
if [ "$TOTAL" -eq 0 ] || [ "$INVALID" -ne 0 ] || [ "$UNKNOWN" -ne 0 ]; then
echo "[planning-with-files] Plan format invalid: use ### 阶段 headings with exactly one native status per phase."
exit 1
fi
printf '[planning-with-files] Plan format valid (%d phases).\n' "$TOTAL"
exit 0
fi
# issue #191: TOTAL=0 -> not phase-structured, stay silent
if [ "$TOTAL" -eq 0 ] && [ "$UNKNOWN" -eq 0 ]; then
exit 0
fi
if [ "$UNKNOWN" -ne 0 ]; then
echo "[planning-with-files] Plan format or read error: phase completion unavailable."
elif [ "$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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |