메뉴
将工作流切换为 Manus 风格的持久化 Markdown 文件，用于规划、进度跟踪和知识存储。适用于复杂任务、多步骤项目、研究任务，或用户提到 planning、organizing work、tracking progress、需要结构化输出时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | planning-with-files |
| description | 将工作流切换为 Manus 风格的持久化 Markdown 文件，用于规划、进度跟踪和知识存储。适用于复杂任务、多步骤项目、研究任务，或用户提到 planning、organizing work、tracking progress、需要结构化输出时。 |
| version | 0.1.0 |
像 Manus 一样工作：把持久化 Markdown 文件当作“磁盘上的工作记忆”。
在任何复杂任务开始前：
[x] 并修改状态对于 hello-scholar 项目，优先在 hello-scholar/plans/<plan-id>/ 下创建 plan package：
| 文件 | 用途 | 更新时机 |
|---|---|---|
requirements.md | 记录用户问题、目标、成功标准、约束、非目标和确认问题 | 计划开始时 |
plan.md | 说明接下来怎么做：修改策略、受影响文件、逐项修改、行为变化、风险和验证计划 | 实施前 |
tasks.md | 跟踪具体任务、文件、具体改动、完成标准、验证、依赖和 traceability | 执行过程中 |
contract.json | 可选的机器可读执行契约 | 当验证 / review 规则重要时 |
创建或更新 plan package 后，必须运行 self-review-gate 的 Plan Self-Review。若发现用户需求缺失、计划项不可验证、范围不清、非目标缺失或 traceability 断裂，先修正计划，再进入实现或请求用户确认。
tasks.md 应明确包含：
涉及文件具体改动完成标准验证方式依赖/阻塞对应计划项对应 change 记录当任务涉及修改规则、prompt、workflow、AGENTS.md、SKILL.md、agent prompt 或 command skill 时，用户可见修改说明必须回答：
我理解的问题：用户指出的失败模式，以及影响的是用户输出、记录资产还是执行行为。修改目标：修改后模型必须多做到什么，哪些误解要被显式避免。修改范围：准备修改哪些文件、section 或 command，哪些相关对象不改。具体修改点：每一处当前不足、准备加入的规则、插入位置和影响输出。行为变化：修改后在什么触发条件下会多输出、记录或验证什么。风险与边界：输出变长、模板机械化、规则冲突等风险，以及哪些场景不强制完整展开。验证方式：通过 diff review、模板完整性检查、dry-run 或测试证明修改生效。职责必须分清：
plan 文件回答“接下来怎么做”，不得冒充完成记录。change 文件回答“实际改了什么”，不得复述未执行计划。对于不使用 hello-scholar 项目资产的通用仓库，旧的三文件模式仍然可接受：
| 文件 | 用途 | 更新时机 |
|---|---|---|
task_plan.md | 跟踪阶段和进度 | 每个阶段后 |
notes.md | 存储发现和研究结果 | 研究过程中 |
[deliverable].md | 最终交付物 | 完成时 |
Loop 1: 创建包含 requirements + plan 的 plan package
Loop 2: 自审 plan package -> 修正缺口 -> 再进入实施
Loop 3: 研究 -> 保存 notes/findings -> 更新 tasks.md
Loop 4: 执行 -> 更新 tasks.md + verification notes
Loop 5: delivery self-review -> 交付最终输出并关闭计划
每个主要动作前：
Read task_plan.md # Refresh goals in attention window
每个阶段后：
Edit task_plan.md # Mark [x], update status
存储信息时：
Write notes.md # Don't stuff context, store in file
推荐结构：
hello-scholar/
\- plans/
\- <plan-id>/
|- requirements.md
|- plan.md
|- tasks.md
\- contract.json
requirements.md# 需求：[简短描述]
## 用户问题
[用户原始问题、核心担忧、显式需求与隐含需求]
## 目标
[1-3 条可验证最终状态]
## 成功标准
- [用户可见输出达到什么标准]
- [plan / change 记录达到什么标准]
- [验证或 review 达到什么标准]
## 约束
- [约束]
## 非目标
- [明确排除的工作]
## 需要确认的问题
- [真正影响实现的问题；如可默认继续，写明默认假设]
plan.md# 计划：[简短描述]
- Route：`[route]`
- Tier：`[tier]`
## 修改策略
[总体方法，以及为什么不是只增加泛化规则]
## 受影响文件
| 文件 | 相关 section / 模块 | 本次职责 |
|---|---|---|
| `[path]` | [section] | [为什么要改] |
## 逐项修改说明
### PLAN-001 [短标题]
- 当前问题：
- 准备修改：
- 插入位置：
- 新增规则：
- 删除或替换内容：
- 影响的输出：
- 与其他规则的关系：
## 行为变化
- [用户可见回答变化]
- [plan / tasks / change 文件变化]
- [不确定信息处理方式变化]
## 风险与缓解
- [风险]：[缓解方式]
## 验证计划
- [模板完整性检查]
- [traceability 检查]
- [测试、dry-run 或人工 review]
## Traceability
| 用户需求 | Plan Item | Task | Changed File | Verification | Status |
|---|---|---|---|---|---|
tasks.md# 任务：[简短描述]
- [ ] 任务 1
涉及文件：[file list]
具体改动：[新增字段 / 修改规则 / 删除或替换内容]
完成标准：[definition of done]
验证方式：[test / review / evidence]
依赖/阻塞：[dependency or none]
对应计划项：[PLAN-001]
对应 change 记录：[完成后填入]
task_plan.md 模板任何复杂任务都要先创建这个文件：
# 任务计划：[简短描述]
## 目标
[一句话描述最终状态]
## 阶段
- [ ] 阶段 1：规划与准备
- [ ] 阶段 2：研究 / 收集信息
- [ ] 阶段 3：执行 / 构建
- [ ] 阶段 4：审查并交付
## 关键问题
1. [需要回答的问题]
2. [需要回答的问题]
## 已做决策
- [决策]：[理由]
## 遇到的错误
- [错误]：[解决方案]
## 状态
**当前处于阶段 X** - [我正在做什么]
notes.md 模板用于研究和发现：
# 笔记：[主题]
## 来源
### 来源 1：[名称]
- URL: [link]
- 关键点：
- [发现]
- [发现]
## 综合发现
### [类别]
- [发现]
- [发现]
复杂任务绝不在没有持久计划文件或 plan package 的情况下开始。这是硬性规则。
在任何重大决策前，读取当前活跃计划文件。这能让目标保持在注意力窗口中。
完成任一阶段后，立即更新活跃计划文件：
[x] 标记已完成阶段完成实现后，运行 self-review-gate 的 Delivery Self-Review，确认计划、任务、实际修改、验证证据和 change record 一致。发现缺口时先回修，再更新计划状态。
大型输出写入文件，不塞进上下文。工作记忆里只保留路径。
每个错误都写入 “遇到的错误” section。这会为未来任务沉淀知识。
以下场景使用持久 plan package：
以下场景可跳过：
| 不要这样做 | 改为这样做 |
|---|---|
| 用 TodoWrite 做持久化 | 创建计划文件或 plan package |
| 只说一次目标然后忘掉 | 每次决策前重新阅读计划 |
| 隐藏错误然后重试 | 把错误记录到计划文件 |
| 把所有东西塞进上下文 | 把大内容存入文件 |
| 直接开始执行 | 先创建计划文件 |
参见 reference.md：
参见 examples.md：
Use when the user asks to generate or refresh an architecture map, structure diagram, core call flow, local viewer assets, or runs ~map. Produces hello-scholar native architecture-map.json plus compact Markdown and Mermaid companion artifacts.
Use when the user asks to open the architecture viewer, view diagrams, inspect node evidence, export the local architecture map, or troubleshoot hello-scholar map view/export behavior.
实验分析命令，基于 experiment package、runs、metrics 和 evidence 形成结果解释与下一轮实验计划。
实现命令，把 plan package、change record 或 experiment package 落成代码、配置、文档或实验变更。
Use only when the user explicitly types ~map. Generates or refreshes the hello-scholar native architecture map by invoking the architecture-map workflow, then validates and points to the local viewer.
用于涉及编写或修改源码的日常编码任务。