Project State【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneProject ReferenceSee: .planning/PROJECT.md (updated [date])Core value:[One-liner from PROJECT.md Core Value section]Current focus:[Current phase name]Current PositionPhase: [X] of [Y] ([Phase name]) Plan: [A] of [B] in current phase Status: [Ready to plan / Planning / Ready to execute / In progress / Phase complete] Last activity: [YYYY-MM-DD] — [What happened]Progress: [░░░░░░░░░░] 0%Performance MetricsVelocity:Total plans completed: [N]Average duration: [X] minTotal execution time: [X.X] hoursBy Phase:PhasePlansTotalAvg/Plan----Recent Trend:Last 5 plans: [durations]Trend: [Improving / Stable / Degrading]Updated after each plan completionAccumulated ContextDecisionsDecisions are logged in PROJECT.md Key Decisions table. Recent decisions affecting current work:[Phase X]: [Decision summary][Phase Y]: [Decision summary]Pending Todos[Pending ideas captured during sessions]None yet.Blockers/Concerns[Issues that affect future work]None yet.Session ContinuityLast session: [YYYY-MM-DD HH:MM] Stopped at: [Description of last completed action] Resume file: [Path to .continue-here*.md if exists, otherwise None]模板的使用要点 - 方括号 [ ] 内的内容为占位符按实际情况替换 - 所有日期字段统一使用 YYYY-MM-DDSession Continuity 中为 YYYY-MM-DD HH:MM格式便于程序化解析与陈旧性判断 - Status 字段的枚举值Ready to plan / Planning / Ready to execute / In progress / Phase complete在 [sdk/src/query/state-document.ts#L50-L69](https://link.gitcode.com/i/87d950925fee0395763379b24d4f4bb1) 的 normalizeStateStatus 中会被归一到 paused / executing / planning / discussing / verifying / completed 等标准状态供工作流路由使用。 ## 三、六大区块逐一拆解每一行都服务于快速恢复认知 ### 3.1 Project Reference指向完整上下文的指针 该区块不重复存放需求与约束而是**指向 PROJECT.md**模板见 [sdk/prompts/templates/project.md](https://link.gitcode.com/i/6ee629faff59f713dfb32e09ffa6de45)并携带三样精华 - **Core value**——项目唯一最重要的那件事the ONE thing that matters防止 Agent 在细节中迷失方向 - **Current focus**——当前聚焦的阶段名 - **Last update date**——PROJECT.md 的最后更新时间。**该日期是陈旧触发器**一旦发现日期过旧就应重新读取 PROJECT.md 以获取最新需求、约束与决策。 需要注意的是STATE.md 只存放摘要Claude Code 在需要时**直接读取 PROJECT.md** 来获取完整的需求、约束和决策内容。 ### 3.2 Current Position当前位置的实时快照 回答我们现在在哪的核心区块 - Phase: [X] of [Y]——处于第几个阶段、共几个阶段 - Plan: [A] of [B]——当前阶段内已推进到第几个计划 - Status——当前状态枚举 - Last activity——最近一次发生的事 - Progress——用可视进度条░░░░░░░░░░呈现整体完成度。 **进度计算公式**模板明确给出progress (已完成计划数) / (全部阶段的总计划数) × 100%在源码层面[state-document.ts#L71-L86](https://link.gitcode.com/i/601d14a290c1e8c321adc684e23c862c) 的 computeProgressPercent 实现了更严谨的双维度算法同时比较计划维度completedPlans/totalPlans与阶段维度completedPhases/totalPhases**取两者较小值**并做 100 上限截断与四舍五入 ts const planFraction hasPlanData ? completedPlans / totalPlans : 1; const phaseFraction hasPhaseData ? completedPhases / totalPhases : 1; return Math.min(100, Math.round(Math.min(planFraction, phaseFraction) * 100));【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
`)
`)
