harness-step3-session-management SKILL.md skillA

harness-step3-session-management from simbajigege/book2skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add simbajigege/book2skills/harness-step3-session-management@git:20260414.6a7e3e4

Pins git:20260414.6a7e3e4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
simbajigege/book2skills
Path
skills/harness-step3-session-management/SKILL.md
Versions recorded
1
Latest version
git:20260414.6a7e3e4, committed Apr 14, 2026
Size
9,442 bytes
Repository stars
202
License
MIT

Harness Engineering 第二阶段:建立跨 session 状态管理,解决 agent 每次对话失忆的问题。 创建 tasks.json(任务清单)、progress.md(进度记录)、init.sh(环境初始化脚本)三个文件。 当用户说"建立任务管理"、"让 agent 记住进度"、"创建 tasks.json"、"跨 session 保持状态"、 "agent 每次都不记得上次做了什么"、"建立 progress 文件"、"初始化状态管理"时,立即使用此 skill。 前置条件:harness-step1 和 harness-step2 已完成(项目有 AGENTS.md 和 docs/ 知识库)。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Harness Step 3: 建立跨 Session 状态管理

## 目标

创建三个文件,让 agent 在任何新 session 开始时能在 30 秒内恢复工作状态:

- `init.sh`:环境初始化脚本,验证项目可以正常启动
- `tasks.json`:当前任务清单,agent 的工作指令来源
- `progress.md`:人类可读的进度摘要,记录每次 session 的关键信息

**核心原则**:状态靠文件传递,不靠 agent 的记忆。git log 是主记录,这三个文件是辅助。

---

## 执行步骤

### Step 1:扫描项目启动方式

在写 `init.sh` 之前,先确认项目如何启动和测试:

```bash
# 读 package.json 的 scripts(Node.js 项目)
cat package.json 2>/dev/null | grep -A 20 '"scripts"'

# 或读 Makefile(多语言项目)
cat Makefile 2>/dev/null | head -40

# 或读 pyproject.toml(Python 项目)
cat pyproject.toml 2>/dev/null | grep -A 20 '\[tool.poetry.scripts\]'

# 确认现有 AGENTS.md 里的启动命令
grep -A 5 '启动命令\|start\|dev\|run' AGENTS.md 2>/dev/null
```

收集:
- 开发服务器启动命令
- 测试命令
- 类型检查/lint 命令(如果有)
- 有没有需要先跑的初始化步骤(如数据库迁移)

---

### Step 2:创建 `init.sh`

`init.sh` 的作用:每次 session 开始时运行,**快速验证环境是否正常**,不正常就立即修复再继续。

```bash
#!/bin/bash
# init.sh — 每次 session 开始时运行
# 验证开发环境处于可工作状态

set -e  # 任何步骤失败就停止

echo "=== 检查环境 ==="

# 1. 确认在正确目录
echo "工作目录: $(pwd)"

# 2. 安装依赖(如果 node_modules 不存在)
# [根据技术栈选择,以下是示例]
# Node.js:
if [ ! -d "node_modules" ]; then
  echo "安装依赖..."
  npm install
fi

# 3. 冒烟测试:验证项目能正常启动
# [根据项目实际情况写,目标是用最快的方式验证基本功能正常]
# 示例:跑一个最快的测试
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add simbajigege/book2skills/harness-step3-session-management@sha256:cf3e2773bee2dc1f

The line at the top of this page pins the label git:20260414.6a7e3e4, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rw4qegutrjqta576.svg)](https://markdownregistry.com/a/art_rw4qegutrjqta576)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Apr 14, 2026.

versioncommittedcommitsizeaudit
git:20260414.6a7e3e4 latest2026-04-14 6a7e3e4 9,442 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9442 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

simbajigege/book2skills · 202 stars · license MIT · pushed 2026-08-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rw4qegutrjqta576
GET https://markdownregistry.com/api/v1/resolve?ref=simbajigege/book2skills/harness-step3-session-management
GET https://markdownregistry.com/api/v1/blob/cf3e2773bee2dc1fb54a842d96c2184f306ab559a0987c60a395e456e2dab34e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from simbajigege/book2skills

agent-memory-implementation SKILL.md skill
simbajigege/book2skills · skills/agent-memory-implementation/SKILL.md · Restructures a chaotic or overgrown MEMORY.md into a clean 2-layer architecture based on how Claude Code's autoDream…
git:20260528.d45c1fe · audit A · 202 stars
agent-tool-builder SKILL.md skill
simbajigege/book2skills · skills/agent-tool-builder/SKILL.md · Define agent tools using the fail-closed design pattern — unified name/schema/security/execution in one class, with…
git:20260612.4cde403 · audit A · 202 stars
analyzing-financial-statements SKILL.md skill
simbajigege/book2skills · skills/analyzing-financial-statements/SKILL.md · Apply Xiao Xing's financial statement analysis framework from 一本书读懂财报 (Understanding Financial Reports in One Book)…
git:20260421.426ae59 · audit A · 202 stars
business-adventures-analysis-brooks SKILL.md skill
simbajigege/book2skills · skills/business-adventures-analysis-brooks/SKILL.md · Use Business Adventures for "why did this fail?", "analyze this crisis", "what pattern applies?", or "what would Brooks…
git:20260429.bf2dad1 · audit A · 202 stars
clash-cultures-investment-speculation-bogle SKILL.md skill
simbajigege/book2skills · skills/clash-cultures-investment-speculation-bogle/SKILL.md · Apply John Bogle stewardship capitalism logic to separate investing from
git:20260430.ba4df11 · audit A · 202 stars
common-sense-index-investing-bogle SKILL.md skill
simbajigege/book2skills · skills/common-sense-index-investing-bogle/SKILL.md · Apply John Bogle index investing rules for low-cost funds, asset allocation,
git:20260430.ba4df11 · audit A · 202 stars
compact-memory-implementation SKILL.md skill
simbajigege/book2skills · skills/compact-memory-implementation/SKILL.md · Developer implementation guide for adding compact memory to an Agent — covers fork agent pattern for compaction…
git:20260524.a98558f · audit A · 202 stars
contagious-viral-content-berger SKILL.md skill
simbajigege/book2skills · skills/contagious-viral-content-berger/SKILL.md · Apply Jonah Berger''s STEPPS framework. Trigger on: "why is this not spreading?", "make this campaign contagious"…
git:20260501.32e482d · audit A · 202 stars
contract-drafting-and-review-guidance-china-law SKILL.md skill
simbajigege/book2skills · skills/contract-drafting-and-review-guidance-china-law/SKILL.md · Apply China contract drafting review with San Guan Si Bu Fa. Trigger on contract review, drafting, clauses, or deal…
git:20260430.5b2ddcd · audit A · 202 stars
creating-superfans-hodak SKILL.md skill
simbajigege/book2skills · skills/creating-superfans-hodak/SKILL.md · Apply Brittany Hodak's SUPER Model for customer loyalty, referrals, word of mouth, personalization, service recovery…
git:20260429.41e55c1 · audit A · 202 stars
customers-yachts-wall-street-schwed SKILL.md skill
simbajigege/book2skills · skills/customers-yachts-wall-street-schwed/SKILL.md · Analyze Wall Street conflicts. Trigger on: "can I trust this advisor?", "is this forecast reliable?", "whose interest…
git:20260501.32e482d · audit A · 202 stars
essays-in-persuasion-keynes SKILL.md skill
simbajigege/book2skills · skills/essays-in-persuasion-keynes/SKILL.md · Apply Keynes policy reasoning. Trigger on: "will austerity work?", "inflation or deflation?", "analyze this economic…
git:20260501.32e482d · audit A · 202 stars

Every file in simbajigege/book2skills

Browse by kind, by grade A, or by owner.