Back to Details

archive

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Inputs

输入参数

  • Plan file path (default: most recent non-
    .done.md
    in 
    ai-workspace/plans/
    )
  • 计划文件路径（默认值：
    ai-workspace/plans/
    目录下最新的非
    .done.md
    格式文件）

Steps

操作步骤

  1. Find the plan file:
    bash
    ls -t ai-workspace/plans/*.md | grep -v '.done.md' | head -1
    If plan is already 
    .done.md
    → error: "Already archived."
  2. Read the plan file to understand what was planned.
  3. Gather outcomes: Ask the user (or infer from git log + branch context):
    • What worked well?
    • What didn't go as planned?
    • What would you do differently?
    If user skips → write "Outcomes: not recorded" (don't block).
  4. Write Outcomes & Learnings section to the plan file:
    markdown
    ## Outcomes & Learnings

**Completed**: [date]

### What Worked
- [bullet points]

### What Didn't
- [bullet points]

### Learnings
- [bullet points]
  5. Rename to .done.md:
    bash
    git mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md
  6. Commit the archive:
    bash
    git add ai-workspace/plans/<name>.done.md
git commit -m "docs: archive plan <name>"
Output: Confirmation that the plan is archived with path to 
.done.md
file.
  1. 查找计划文件:
    bash
    ls -t ai-workspace/plans/*.md | grep -v '.done.md' | head -1
    如果计划文件已经是
    .done.md
    格式 → 报错："已归档。"
  2. 读取计划文件，了解原定的计划内容。
  3. 收集成果信息：询问用户（或从git日志+分支上下文推断）：
    • 哪些部分进展顺利？
    • 哪些部分没有按计划推进？
    • 你会做出哪些调整？
    如果用户跳过填写 → 写入"成果：未记录"即可（不要阻塞流程）。
  4. 向计划文件中写入成果与经验总结章节:
    markdown
    ## Outcomes & Learnings

**Completed**: [date]

### What Worked
- [bullet points]

### What Didn't
- [bullet points]

### Learnings
- [bullet points]
  5. 重命名为.done.md格式:
    bash
    git mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md
  6. 提交归档内容:
    bash
    git add ai-workspace/plans/<name>.done.md
git commit -m "docs: archive plan <name>"
输出：计划已归档的确认信息，以及
.done.md
文件的路径。