wrap-session

用途

wrap-session 是一个会话收尾技能，用于在一段重要工作会话结束时进行系统化整理。当用户要求“wrap up session”“end session”“session wrap”“/wrap”“/wrap-session”“document learnings”等时触发。它适合在完成一个功能或修复一个 bug 之后、切换到其他项目之前使用。

主要能力

该技能通过多智能体分析完成收尾工作，执行流程如下：

检查 Git 状态。
第一阶段：并行运行 4 个分析智能体。
第二阶段：顺序运行验证智能体。
整合结果并询问用户。
执行用户选定的操作。

第一阶段：分析智能体（并行）

以单条消息发起 4 个 Task 调用并行执行，并向所有智能体提供会话摘要（Session Summary），包含：Work（会话中执行的主要任务）、Files（创建/修改的文件）、Decisions（做出的关键决策）。

四个智能体及其角色与输出：

doc-updater：分析 CLAUDE.md/context.md 的更新需求，输出具体要添加的内容。
automation-scout：检测自动化模式，输出 skill/command/agent 建议。
learning-extractor：提取学习点，输出 TIL 格式摘要。
followup-suggester：建议后续任务，输出按优先级排序的任务列表。

第二阶段：验证智能体（顺序）

在第一阶段完成后运行 duplicate-checker，验证第一阶段分析结果。它会检查提案是否与现有文档/自动化重复：完全重复则建议跳过；部分重复则建议合并方式；无重复则批准添加。

使用方式

步骤 1：检查 Git 状态

git status --short
git diff --stat HEAD~3 2>/dev/null || git diff --stat

步骤 2：第一阶段 - 分析智能体（并行）

Task(
    subagent_type="doc-updater",
    description="Document update analysis",
    prompt="[Session Summary]\n\nAnalyze if CLAUDE.md, context.md need updates."
)

Task(
    subagent_type="automation-scout",
    description="Automation pattern analysis",
    prompt="[Session Summary]\n\nAnalyze repetitive patterns or automation opportunities."
)

Task(
    subagent_type="learning-extractor",
    description="Learning points extraction",
    prompt="[Session Summary]\n\nExtract learnings, mistakes, and new discoveries."
)

Task(
    subagent_type="followup-suggester",
    description="Follow-up task suggestions",
    prompt="[Session Summary]\n\nSuggest incomplete tasks and next session priorities."
)

步骤 3：第二阶段 - 验证智能体（顺序）

Task(
    subagent_type="duplicate-checker",
    description="Phase 1 proposal validation",
    prompt="""
Validate Phase 1 analysis results.

## doc-updater proposals:
[doc-updater results]

## automation-scout proposals:
[automation-scout results]

Check if proposals duplicate existing docs/automation:
1. Complete duplicate: Recommend skip
2. Partial duplicate: Suggest merge approach
3. No duplicate: Approve for addition
"""
)

步骤 4：整合结果

整合为“Wrap Analysis Results”，包含：Documentation Updates（含重复检查反馈）、Automation Suggestions（含重复检查反馈）、Learning Points、Follow-up Tasks。

步骤 5：操作选择

AskUserQuestion(
    questions=[{
        "question": "Which actions would you like to perform?",
        "header": "Wrap Options",
        "multiSelect": true,
        "options": [
            {"label": "Create commit (Recommended)", "description": "Commit changes"},
            {"label": "Update CLAUDE.md", "description": "Document new knowledge/workflows"},
            {"label": "Create automation", "description": "Generate skill/command/agent"},
            {"label": "Skip", "description": "End without action"}
        ]
    }]
)

步骤 6：执行选定操作

仅执行用户选定的操作。

适用场景

重要工作会话结束时。
切换到不同项目之前。
完成一个功能或修复一个 bug 之后。

限制与跳过条件

以下情况建议跳过：

会话非常短且改动微不足道。
仅阅读/探索代码。
快速回答一次性问题。

参数

空参数：交互式进行（完整工作流）。
提供消息：用作提交消息并直接提交。

附加资源

详细编排模式参见 references/multi-agent-patterns.md。