dsh-skill-writing-plans
给 DeepSeek Harness 加上「先写计划，再动手」的习惯。
装上这个插件，Agent 在接到任何写代码、做页面、跑实验的请求时，会先产出一份结构化的实现计划，再开始动手——而不是直接埋头写代码。
A DeepSeek Harness skill plugin that adds the writing-plans skill: the agent writes a structured implementation plan before coding, executes simple tasks inline, and offers an execution choice for complex work.
它为你做什么
| |
|---|
| 不用提醒它做计划 | 只要请求涉及写代码、做页面、跑实验，Agent 会自己先规划 |
| 计划有固定去处 | 总是写到 docs/superpowers/plans/YYYY-MM-DD-<功能名>.md，方便你回看和归档 |
| 小事不啰嗦 | 只写一个 index.html 这种单步任务，Agent 直接做完，不会拿"要选哪种执行方式"来烦你 |
| 大事给你选择权 | 多文件、多任务、训练类需求，保存计划后会问你是派子代理并行执行，还是当前会话里逐步执行 |
| 计划能直接照着做 | 每个任务都有具体文件路径、完整代码、可执行命令和预期结果，没有 TBD、TODO、"稍后实现"这类占位 |
安装
从 npm 安装（推荐）
npm install dsh-skill-writing-plans
或在 DSH 里直接装：
dsh plugin add dsh-skill-writing-plans@0.1.0
DSH 桌面客户端用户请用这一种。 桌面客户端的安装边界只接受已发布到 npm 的包，纯 GitHub 源的插件在桌面端装不了。
从插件市场安装
- 打开 DeepSeek Harness → 插件市场
- 搜索
writing-plans 或 dsh-skill-writing-plans
- 点击安装，按提示重启 DSH
市场条目收录后即可搜到；收录前请用上面的 npm 方式。
从 GitHub 源码安装（仅普通 dsh web / CLI）
git clone https://github.com/linlin539/dsh-skill-writing-plans.git
然后在你使用的 DSH profile 目录下，把仓库放到 packages/dsh-skill-writing-plans，并在 profile 的 package.json 里加一行依赖：
{
"dependencies": {
"dsh-skill-writing-plans": "link:packages\\dsh-skill-writing-plans"
}
}
再在 profile 的 cordis.patch.yml 末尾加上：
- insert:
- id: skill-writing-plans
name: dsh-skill-writing-plans
重启 DeepSeek Harness 即可生效。
只想用技能文件
不想装插件的话，把 assets/writing-plans/SKILL.md 放到下面任一位置也可以：
- 项目级：
{你的项目}/.dsh/skills/writing-plans/SKILL.md
- 用户级：
{DSH_HOME}/skills/writing-plans/SKILL.md
用起来是什么样
简单需求：直接做完
你说：
帮我写一个 index.html，页面中央显示 'Hello World'
Agent 会：
- 声明正在使用
writing-plans 技能
- 快速看一眼当前工作区
- 把计划写到
docs/superpowers/plans/2026-10-17-hello-world-page.md
- 因为只有单一步骤，直接创建
index.html，不问你任何问题
- 告诉你做完了，以及计划文件在哪
复杂需求：让你选怎么执行
你说：
帮我实现一个学生信息管理系统，包含增删改查和数据库
Agent 会先把完整计划写好并保存，然后问你：
Plan saved to docs/superpowers/plans/2026-10-17-student-management-system.md. Two execution options:
- Subagent-Driven（推荐） — 每个任务派一个子代理独立执行
- Inline Execution — 在当前会话中逐步执行，每步有检查点
Which approach?
只想看计划
只出计划，先不要写代码
Agent 就只保存计划文档，不动任何代码。
计划文档长什么样
# Hello World 页面 Implementation Plan
**Goal:** 交付一个静态页面，在浏览器视口正中央显示 `Hello World`。
**Architecture:** 单文件纯静态实现，用 Flexbox 在 `body` 上做双向居中。
**Tech Stack:** HTML5 + CSS3
---
## Task 1: 创建居中的 Hello World 页面
**Files:**
- Create: `index.html`
- Modify: 无
- Test: 无
- [ ] **Step 1: 写入 `index.html`**
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>Hello World</title>
</head>
<body>
<h1>Hello World</h1>
</body>
</html>
```
- [ ] **Step 2: 在浏览器中打开验证**
Run: 双击 `index.html`
Expected: 页面正中央显示 `Hello World`
---
## Self-Review
1. 需求覆盖：文件名与居中显示均已覆盖。
2. 无占位内容。
3. 路径与文件名前后一致。
常见问题
装完之后在 DSH 主界面没看到这个插件？
这是正常的。本插件只往 Host 侧注册技能，不带任何界面组件，所以不会出现在主插件列表里。可以在插件市场的已安装列表中确认，或查看 DSH 日志。
DSH 桌面客户端从 GitHub 源装不了？
桌面客户端的安装边界只接受已发布到 npm 的、带精确版本号的包（name@x.y.z），纯 GitHub 源会被拒绝。请改用 npm 安装方式：
dsh plugin add dsh-skill-writing-plans@0.1.0
计划文档还是又长又啰嗦？
请确认你看的是新生成的文件。工作区里早先版本留下的旧计划不会被自动删除。
它会不会每次都问我要不要先做计划？
不会。触发即进入规划模式，直接开始做。
能关掉它吗？
可以，在插件市场里禁用或卸载即可。也可以只在个别会话里不使用——它不会强制接管所有请求。
怎么更新到新版本？
npm install dsh-skill-writing-plans@latest
或查看当前版本：
npm view dsh-skill-writing-plans version
许可
MIT © linlin539
