@klarkxy/dsh-dev-index 0.1.0 → 0.1.1

package/README.md

@@ -2,28 +2,30 @@
 
 [Chinese documentation](README.zh-CN.md)
 
-A DeepSeek Harness bundle that points an agent at one index of DSH features and extension points while it writes plugins, presets, patches, profiles, providers, or other DSH secondary development.
+A DeepSeek Harness bundle that walks an agent through a short workflow: confirm the target DSH version, prefer the official plugin-development skill and runtime inspection when they exist, pick a task, then verify the plugin. The docs stay outside this package.
 
-The index itself is not in this package. `docs/` in [klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) is the only copy, and it is published at [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/). `docs/meta.json` records `officialTag` and `officialCommit` for the [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) revision those pages describe. Every area names the official file it came from. The index does not invent APIs.
+The index itself is not in this package. `docs/` in [klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) is the only copy, and it is published at [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/). `docs/meta.json` records `officialTag` and `officialCommit` for the [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) revision those pages describe. Every area, task, and architecture-rules page names the official file it came from. The index does not invent APIs.
 
 ## Why a skill
 
 DSH's agent-facing knowledge contract is a skill on `ctx.skills`. `@deepseek-ai/dsh-skill` documents `ctx.skills.register` for an embedded instruction set, and `@deepseek-ai/dsh-tool-skill` puts model-invocable skills in the session catalog and loads them with the `skill` tool. A preset would replace the agent's composition. A tool would have to be called before the agent knew the index existed. A host-level skill is listed beside the agent's other skills and stays available in every base-backed profile.
 
-On `apply`, this plugin registers the skill `dsh-dev-index`. The body only tells the agent where to fetch the current index:
+On `apply`, this plugin registers the skill `dsh-dev-index`. The body is a short workflow, then the fetch list. It tells the agent to compare `meta.json` `officialTag` and `officialCommit` with the target DSH version and, on a mismatch, to treat the pages as unverified. It does not embed that revision, so a daily docs refresh does not require a new package release.
 
 - `https://klarkxy.github.io/dsh-plugins/llms.txt`
 - `https://klarkxy.github.io/dsh-plugins/index.json`
 - `https://klarkxy.github.io/dsh-plugins/meta.json`
+- `https://klarkxy.github.io/dsh-plugins/tasks/index.md`
+- `https://klarkxy.github.io/dsh-plugins/tasks/<id>.md`
 - `https://klarkxy.github.io/dsh-plugins/areas/<id>.md`
 
-English is the default. Human-readable pages also exist in Simplified Chinese under `zh/` (for example `zh/llms.txt` and `zh/areas/<id>.md`). `index.json` and `meta.json` stay in English.
+English is the default. Human-readable pages also exist in Simplified Chinese under `zh/` (for example `zh/llms.txt`, `zh/tasks/<id>.md`, and `zh/areas/<id>.md`). `index.json` and `meta.json` stay in English.
 
 If Pages does not respond, the same paths are on GitHub `main`:
 
 `https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/`
 
-The body also lists area ids so the agent knows which `areas/<id>.md` files exist. It does not copy page text or the indexed commit, so a daily docs refresh does not require a new package release.
+The body also lists task ids and area ids so the agent knows which files exist. It does not copy page text.
 
 `sdk-minimal` does not mount `@deepseek-ai/dsh-skill`. There the plugin stays pending because it injects `skills`. Web, headless, sdk, and acp build on `@deepseek-ai/dsh-base`, which mounts the registry.
 

package/README.zh-CN.md

@@ -2,28 +2,30 @@
 
 [English documentation](README.md)
 
-这是一个 DeepSeek Harness bundle。Agent 在编写插件、Preset、补丁、Profile、Provider，或做其他 DSH 二次开发时，用它找到 DSH 功能与扩展点的索引。
+这是一个 DeepSeek Harness bundle。它给 agent 一段短流程：确认目标 DSH 版本，在官方插件开发技能和运行时检查可用时优先使用它们，再选一个任务并验证插件。文档不在这个包里。
 
-索引正文不在这个包里。[klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) 仓库的 `docs/` 是唯一副本，并发布在 [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/)。`docs/meta.json` 记录这些页面所描述的 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 修订：`officialTag` 与 `officialCommit`。每个章节都标明官方文件路径。索引不发明 API。
+索引正文不在这个包里。[klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) 仓库的 `docs/` 是唯一副本，并发布在 [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/)。`docs/meta.json` 记录这些页面所描述的 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 修订：`officialTag` 与 `officialCommit`。每个 area、任务和架构规则页都标明官方文件路径。索引不发明 API。
 
 ## 为什么用 skill
 
 DSH 面向 agent 的知识契约是 `ctx.skills` 上的 skill。`@deepseek-ai/dsh-skill` 用 `ctx.skills.register` 登记嵌入式说明，`@deepseek-ai/dsh-tool-skill` 把模型可调用的 skill 放进会话目录，并用 `skill` 工具加载。Preset 会换掉 agent 的组合。工具必须先被调用，agent 才知道索引存在。宿主层 skill 会和其他 skill 一起出现在目录里，base 上的 profile 都能用。
 
-`apply` 时本插件登记 skill `dsh-dev-index`。正文只告诉 agent 去哪里读取当前索引：
+`apply` 时本插件登记 skill `dsh-dev-index`。正文先是一段短流程，再列出读取地址。它让 agent 把 `meta.json` 的 `officialTag`、`officialCommit` 和目标 DSH 版本比较；不一致时把页面当作未经核实。正文不写入该修订，因此每天刷新 `docs/` 不需要发布新的插件包。
 
 - `https://klarkxy.github.io/dsh-plugins/llms.txt`
 - `https://klarkxy.github.io/dsh-plugins/index.json`
 - `https://klarkxy.github.io/dsh-plugins/meta.json`
+- `https://klarkxy.github.io/dsh-plugins/tasks/index.md`
+- `https://klarkxy.github.io/dsh-plugins/tasks/<id>.md`
 - `https://klarkxy.github.io/dsh-plugins/areas/<id>.md`
 
-英文是默认语言。给人读的页面在 `zh/` 下另有简体中文版（例如 `zh/llms.txt` 和 `zh/areas/<id>.md`）。`index.json` 和 `meta.json` 保持英文。Agent 默认仍读取上面的英文文件。
+英文是默认语言。给人读的页面在 `zh/` 下另有简体中文版（例如 `zh/llms.txt`、`zh/tasks/<id>.md` 和 `zh/areas/<id>.md`）。`index.json` 和 `meta.json` 保持英文。Agent 默认仍读取上面的英文文件。
 
 Pages 没有响应时，同样的路径在 GitHub 的 `main` 上：
 
 `https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/`
 
-正文还列出 area id，方便 agent 知道有哪些 `areas/<id>.md`。它不复制页面正文，也不写入被索引的 commit，因此每天刷新 `docs/` 不需要发布新的插件包。
+正文还列出任务 id 和 area id，方便 agent 知道有哪些文件。它不复制页面正文。
 
 `sdk-minimal` 没有挂载 `@deepseek-ai/dsh-skill`。本插件 `inject` 了 `skills`，在那里会一直等待。`web`、`headless`、`sdk` 和 `acp` 建立在 `@deepseek-ai/dsh-base` 上，base 会挂载这个注册表。
 

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "@klarkxy/dsh-dev-index",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "lib/index.js",
-  "description": "DeepSeek Harness feature index for agents doing DSH secondary development.",
+  "description": "Workflow skill that helps an agent pick a DeepSeek Harness extension mechanism and deliver a verified plugin.",
   "engines": {
     "dsh": ">=0.1.7-rc.2 <0.2.0"
   },

package/lib/skill-body.d.ts

@@ -1,8 +1,10 @@
 export declare const RAW_DOCS_BASE = "https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/";
 export declare const SKILL_NAME = "dsh-dev-index";
-export declare const SKILL_DESCRIPTION = "Look up DeepSeek Harness features and extension points before writing plugins, bundles, presets, patches, profiles, providers, tools, skills, hooks, or UI. Cites the official repository. Do not invent DSH APIs.";
-export declare const SKILL_WHEN_TO_USE = "Use when the task is DSH secondary development: plugins, presets, patches, profiles, providers, tools, skills, hooks, MCP servers, UI slots, or config keys.";
+export declare const SKILL_DESCRIPTION = "Pick a DeepSeek Harness extension mechanism and deliver a verified plugin. Prefer the official plugin-development skill and runtime inspection inside DSH. Cite pinned docs. Do not invent APIs.";
+export declare const SKILL_WHEN_TO_USE = "Use for DSH secondary development when choosing how to extend the harness: tools, execution policy, settings UI, panels, session-derived state, or providers.";
 /** Area ids the skill names so an agent knows what to fetch. Docs stay authoritative. */
 export declare const AREA_IDS: readonly ["orientation", "plugin-module", "bundle-profile-patch", "cli", "tools", "skills", "presets-persona", "system-prompt", "sessions-titles", "llm-providers", "hooks", "mcp", "ui-slots", "settings-approval", "plugin-manager-inspect", "other-seams"];
+/** Task ids. The architecture-rules guide is a page, not a task pack. */
+export declare const TASK_IDS: readonly ["add-a-tool", "add-a-tool-policy", "add-a-settings-ui", "add-a-ui-panel", "add-session-derived-state", "implement-or-replace-a-provider"];
 export declare function renderSkillBody(pagesBaseUrl: string): string;
 //# sourceMappingURL=skill-body.d.ts.map

package/lib/skill-body.js

@@ -1,8 +1,8 @@
 const BODY_LIMIT = 7500;
 export const RAW_DOCS_BASE = "https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/";
 export const SKILL_NAME = "dsh-dev-index";
-export const SKILL_DESCRIPTION = "Look up DeepSeek Harness features and extension points before writing plugins, bundles, presets, patches, profiles, providers, tools, skills, hooks, or UI. Cites the official repository. Do not invent DSH APIs.";
-export const SKILL_WHEN_TO_USE = "Use when the task is DSH secondary development: plugins, presets, patches, profiles, providers, tools, skills, hooks, MCP servers, UI slots, or config keys.";
+export const SKILL_DESCRIPTION = "Pick a DeepSeek Harness extension mechanism and deliver a verified plugin. Prefer the official plugin-development skill and runtime inspection inside DSH. Cite pinned docs. Do not invent APIs.";
+export const SKILL_WHEN_TO_USE = "Use for DSH secondary development when choosing how to extend the harness: tools, execution policy, settings UI, panels, session-derived state, or providers.";
 /** Area ids the skill names so an agent knows what to fetch. Docs stay authoritative. */
 export const AREA_IDS = [
     "orientation",
@@ -22,26 +22,53 @@ export const AREA_IDS = [
     "plugin-manager-inspect",
     "other-seams",
 ];
+/** Task ids. The architecture-rules guide is a page, not a task pack. */
+export const TASK_IDS = [
+    "add-a-tool",
+    "add-a-tool-policy",
+    "add-a-settings-ui",
+    "add-a-ui-panel",
+    "add-session-derived-state",
+    "implement-or-replace-a-provider",
+];
 export function renderSkillBody(pagesBaseUrl) {
     const lines = [
-        "Look up DeepSeek Harness before writing a plugin, preset, patch, profile, provider, tool, skill, hook, MCP server, or UI slot.",
-        "Read the index before editing code. Do not invent APIs. This skill does not bundle a copy of the docs.",
+        "Deliver a verified DeepSeek Harness plugin. Do not invent APIs. This skill does not bundle a copy of the docs.",
+        "",
+        "1. Confirm the development goal and the target DSH version: the tag or commit the process is actually running.",
+        "2. Read meta.json. officialTag and officialCommit are the DSH revision these pages were written against. If the target version differs, treat every page as unverified for that version and check type declarations and source pinned to the target commit. Do not silently substitute this index for another version.",
+        "3. Inside a running DSH, check whether the official cordis-plugin-development skill and the runtime tools cordis_inspect_list and cordis_inspect_query are available. Prefer that skill for install, configuration, and debugging, and prefer those tools for what is actually mounted. cordis_inspect_query does not itself request danger-full-access. Every plugin_manager action does. The environment's tool permission policy still applies to both.",
+        "4. Outside DSH, do not assume those tools exist. Read the docs, type declarations, and source pinned to the target version. Mark every conclusion that could not be runtime-verified.",
+        "5. Open the task index, pick one task, and load the linked area pages, official contracts, and constraints. Read tasks/architecture-rules.md before choosing a mechanism.",
+        "6. Verify the exact APIs you will call. Use runtime inspection when it is available. Otherwise use the pinned types. Do not copy an API from memory.",
+        "7. Implement, then run that task's verification checklist.",
+        "8. Report which checklist items were verified and which remain unverified.",
         "",
-        "Fetch the always-current English index from GitHub Pages:",
+        "Context7 (/deepseek-ai/deepseek-harness) tracks master. Use it only as a secondary source for scattered examples. It is not this index's pinned revision. If it disagrees with the target version, ignore it.",
+        "",
+        "Fetch the English index from GitHub Pages:",
         `- ${pagesBaseUrl}llms.txt`,
         `- ${pagesBaseUrl}index.json`,
         `- ${pagesBaseUrl}meta.json`,
+        `- ${pagesBaseUrl}tasks/index.md`,
+        `- ${pagesBaseUrl}tasks/<id>.md`,
+        `- ${pagesBaseUrl}tasks/architecture-rules.md`,
         `- ${pagesBaseUrl}areas/<id>.md`,
         "",
-        "index.json is the catalog: area id, summary, and official source paths. meta.json records officialTag and officialCommit for the DeepSeek Harness revision those pages describe. Read index.json, then open the one area file the task needs. English is the default.",
-        "Simplified Chinese human-readable pages exist under zh/ on the same hosts (zh/llms.txt and zh/areas/<id>.md). index.json and meta.json stay in English.",
+        "index.json lists task ids, guide ids, and area ids. meta.json records officialTag and officialCommit. English is the default. Simplified Chinese human-readable pages live under zh/ (zh/llms.txt, zh/tasks/<id>.md, zh/areas/<id>.md). index.json and meta.json stay in English.",
         "",
         "If the Pages site does not respond, fetch the same files from GitHub main:",
         `- ${RAW_DOCS_BASE}llms.txt`,
         `- ${RAW_DOCS_BASE}index.json`,
         `- ${RAW_DOCS_BASE}meta.json`,
+        `- ${RAW_DOCS_BASE}tasks/index.md`,
+        `- ${RAW_DOCS_BASE}tasks/<id>.md`,
+        `- ${RAW_DOCS_BASE}tasks/architecture-rules.md`,
         `- ${RAW_DOCS_BASE}areas/<id>.md`,
         "",
+        "Task ids:",
+        ...TASK_IDS.map((id) => `- ${id}`),
+        "",
         "Area ids:",
         ...AREA_IDS.map((id) => `- ${id}`),
     ];

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "DSH development index",
-    "description": "Help agents find DSH features, extension points, and development documentation."
+    "description": "Help an agent pick a DSH extension mechanism and deliver a verified plugin."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "DSH 开发索引",
-    "description": "帮助智能体查找 DSH 功能、扩展点和开发文档。"
+    "description": "帮助智能体选择 DSH 扩展机制并交付经过验证的插件。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@klarkxy/dsh-dev-index",
-  "version": "0.1.0",
-  "description": "DeepSeek Harness feature index for agents doing DSH secondary development.",
+  "version": "0.1.1",
+  "description": "Workflow skill that helps an agent pick a DeepSeek Harness extension mechanism and deliver a verified plugin.",
   "icon": "./icon.svg",
   "keywords": [
     "dsh-plugin",
@@ -84,6 +84,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dshRelease": {
-    "contentHash": "600dea2ae0a93ba3eedb1bb6e1a30299139f9b96fe30a2accb28165973efef99"
+    "contentHash": "271e90a176f8975205471618d07c5841fdbddbb080174f6e53c8226b6175b476"
   }
 }