dsh-study-steward

Readme

# dsh-study-steward

An agent preset for **DeepSeek Harness** (DSH) that turns a session into a personal
**study-and-execution steward**: one entry point that identifies, organises, archives and
follows through on your own learning materials — plans, vocabulary, algorithms, review, and
the decisions you make in conversation.

It is a **configuration-only preset**. The substance is the `cordis.patch.yml` declaration
(persona + tool composition) plus a generic Markdown rule pack under `rules/`.

## What it does

- **Full Standard tool surface.** The preset declares the same plugin rows as the shipped
  `standard` preset — shell, files, search, background jobs, skills, goals, plan mode,
  compaction, subagents and the workflow engine, todo, web, present. Only the persona changes,
  so you lose no capability by switching to it.
- **A study-steward persona** carrying the discipline the rule pack assumes: three state
  dimensions kept apart (content / task / mastery), a daily plan and a daily actual record in
  **separate** files, recommendations that never silently become commitments, and receipts that
  claim only what actually happened.
- **A generic rule pack** in `rules/`: day-to-day entry rules, the full behavioural spec, a
  template-and-archiving specification, 26 content templates with an index, and 19 worked
  examples.

## Install

```
dsh plugin add github:adsikito/dsh-study-steward
```

Or install this directory through the plugin manager:

```
plugin_manager  action: install_bundle
target: <absolute path to this repository>
```

Then start a **new session** and pick **个人学习与执行总管** in the preset selector.
Sessions that already exist keep the preset revision they started with.

## Using the rule pack

The persona points at `rules/` inside this package. For the agent to work with it the way it
works with your own notes, copy the pack into your notes directory (an Obsidian vault is a good
fit):

```
cp -r "<installed package>/rules" ./study-rules
```

The persona prefers a workspace copy of the rule package whenever one exists, so your local
copy always wins over the bundled one.

## What is not included

This repository ships **only** the preset and a generic rule pack. The personal study
materials the spec was originally derived from — course documents, a personal profile, progress
records — are **not** part of this distribution, and the spec marks the places where it refers
to them. Supply your own materials.

Everything under `rules/参考示例/` is **fictional**. Its DEMO tasks, durations, completion dates
and scores must never be recorded as real tasks, progress or history.

## Versions

| Version | Rule pack | Notes |
|---|---|---|
| 1.1.0 | v4.6 | 26 templates with a template index, `02_模板与归档规范.md`, 19 worked examples, 18 adopted mature methods (spec §22); persona carries the example-isolation and mature-method rules. |
| 1.0.0 | v4.3 | Initial release: 9 templates and the v4.3 spec. |

See [CHANGELOG.md](CHANGELOG.md).

## Language

The rule pack and the persona's working agreement are written in Chinese, because the pack is
a Chinese-language specification for a Chinese-language study system. The preset itself
(plugin rows, structure) is language-neutral, and the persona asks the agent to reply in
whatever language the user writes in.

## License

MIT — see [LICENSE](LICENSE).

---

## 中文说明

这是一个 **DeepSeek Harness 的 Agent 预设**：把一个会话变成「个人学习与执行总管」，用一个入口统一处理
计划、生词、算法、复盘、归档和对话中形成的结论。

它是**纯配置预设**——全部内容就是 `cordis.patch.yml` 里的一份预设声明（人格 + 工具组合），外加
`rules/` 下的通用 Markdown 规则包。工具面与内置 `standard` 预设一致，只替换人格，因此不会损失能力。

安装：

```
dsh plugin add github:adsikito/dsh-study-steward
```

安装后**新建会话**，在预设选择器里选「个人学习与执行总管」。已存在的会话保留它启动时的版本。

**不包含**：本仓库只发布预设与通用规则包。规范原文所依据的个人学习资料（课程文档、个人档案、进度记录）
**未包含**在内，规范中相应位置已标注。请使用你自己的资料。

`rules/参考示例/` 下**全部为虚构内容**，其演示任务、用时、完成日期与成绩不得记为真实任务、进度或历史。
`rules/模板/00_模板目录.md` 是 26 份模板的入口；第 22 节的 18 项成熟方法各自带触发条件，只在条件成立时采用。