记录会话Skill record-session

此技能是一种用于软件开发中的工作进度记录工具,通过自动化脚本在代码测试和提交后记录开发会话,包括会话标题、提交哈希和摘要,便于追踪开发历史和任务管理。关键词:软件开发,工作进度,代码提交,自动化记录,Git工具,会话管理

DevOps 0 次安装 0 次浏览 更新于 3/13/2026

名称: record-session 描述: “[!] 前提条件: 此命令应仅在人类测试并提交代码后使用。”

[!] 前提条件: 此命令应仅在人类测试并提交代码后使用。

AI 不得执行 git commit - 只读取历史记录(git loggit statusgit diff)。


记录工作进度(简化 - 仅两个步骤)

步骤 1: 获取上下文

python3 ./.trellis/scripts/get_context.py

步骤 2: 一键添加会话

# 方法 1: 简单参数
python3 ./.trellis/scripts/add_session.py \
  --title "会话标题" \
  --commit "hash1,hash2" \
  --summary "所做工作的简要摘要"

# 方法 2: 通过标准输入传递详细内容
cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --title "标题" --commit "哈希"
| 功能 | 描述 |
|---------|-------------|
| 新 API | 添加了用户身份验证端点 |
| 前端 | 更新了登录表单 |

**更新文件**:
- `packages/api/modules/auth/router.ts`
- `apps/web/modules/auth/components/login-form.tsx`
EOF

自动完成:

  • [OK] 追加会话到 journal-N.md
  • [OK] 自动检测行数,如果超过 2000 行则创建新文件
  • [OK] 更新 index.md(总会话数 +1,最后活动时间,行统计,历史记录)

存档已完成任务(如果有)

如果本次会话完成了任务:

python3 ./.trellis/scripts/task.py archive <任务名称>

脚本命令参考

命令 目的
python3 ./.trellis/scripts/get_context.py 获取所有上下文信息
python3 ./.trellis/scripts/add_session.py --title "..." --commit "..." 一键添加会话(推荐)
python3 ./.trellis/scripts/task.py create "<标题>" [--slug <名称>] 创建新任务目录
python3 ./.trellis/scripts/task.py archive <名称> 存档已完成任务
python3 ./.trellis/scripts/task.py list 列出活动任务