dsh-trellis

简体中文 · English

把 Trellis 任务驱动开发工作流集成进 DeepSeek Harness（dsh）： 全套 Trellis 技能、/trellis-* 命令、一键 .trellis/ 脚手架、每轮工作流状态注入——DSH 没有 hook 也能跑。

生态话题：#dsh-plugin · #dsh · #trellis

本项目（本插件 + Trellis 上游的 dsh 平台注册）完全由 DeepSeek V4 Flash （max reasoning effort）+ DeepSeek Harness 会话完成，见 本项目是如何实现的。

特性

工作原理（与 hook 平台的对照）

Trellis 在带 hook 的平台（Claude Code、Cursor、Qoder、OpenCode…）上自动注入上下文。 DSH 没有 hook，本插件把每个 hook 映射为 DSH 的等价机制：

行为细节：

• 面包屑只注入主会话（子代理的派发 prompt 自带任务行，与上游跳过子代理的行为一致）；
• 任务状态解析对齐 Trellis 自身契约：只信任 .trellis/.runtime/sessions/ 下恰好一个指针文件（多窗口隔离），再回退 .trellis/.current-task；
• 非 Trellis 工作区完全不打扰（不注册 section）。

注入效果示例

每轮 prompt 组装时，app:trellis section 会注入类似下面的块（正文来自 workflow.md 对应 [workflow-state:STATUS] 标签，不是写死的文案）：

<trellis-workflow>
Status: no_task
No active task. First classify the current turn and ask for task-creation consent before creating any Trellis task.
Simple conversation / small task: ask only whether this turn should create a Trellis task. ...

This workspace uses the Trellis workflow. Follow it: load the `trellis-start` skill at session start and when a new task arrives, route per the skill routing table in `.trellis/workflow.md`, and run `python3 .trellis/scripts/get_context.py` / `task.py current` for live state. Do not skip the DO-NOT-skip steps.
</trellis-workflow>

有活动任务时，首行变成 Task: <id> (<status>)，正文换成对应阶段（ planning / in_progress / completed…）的指引。完整会话上下文 （developer、git 状态、spec 索引）仍需模型按 trellis-start 技能用 bash 拉取——注入的是"轨道"，不是"全量数据"。

前置要求

• 正在运行的 DeepSeek Harness profile（如 dsh web）
• Python 3.9+（跑 .trellis/scripts/ 的 task.py、get_context.py 等）
• PATH 上有 pnpm（dsh plugin 依赖）

安装

# 从 GitHub 安装（公开仓库）
dsh plugin --profile web add git+https://github.com/Beants/dsh-trellis.git

# 或本地 checkout
dsh plugin --profile web add /path/to/dsh-trellis

在 ~/.dsh/profiles/web/cordis.patch.yml 中启用（追加一条顶层 insert）：

- insert:
    - name: dsh-trellis
      config: {}

验证并重启：

dsh --profile web --dump-config   # 组合树中出现 dsh-trellis 行
# 重启 dsh web，然后刷新浏览器

快速开始

1. 把会话工作区切到你的项目。
2. 执行 /trellis-init 你的名字——生成 .trellis/（config.yaml、workflow.md、scripts/、agents/ 等）并追加 .gitignore 条目。
3. 用自然语言描述开发任务。agent 会加载 trellis-start，走 规划 → 实现 → 验证 → 收尾 循环：brainstorm 产出 prd.md、派发 trellis-agent-implement / trellis-agent-check 子代理实现与校验，最后 trellis-finish-work 归档任务并写工作日志。

命令

配置

插件导出 Schemastery Config schema（可在 profile 的 patch 层覆盖）：

- id: dsh-trellis
  name: dsh-trellis
  config:
    injectWorkflowState: true    # 是否注入每轮 <trellis-workflow> 面包屑（默认 true）
    workflowSectionOrder: -97    # prompt section 顺序（默认 -97）
    pythonCommand: python3       # .trellis/scripts 的解释器；Windows 上设为 python

技能清单

开发（资产再生成）

assets/skills/ 是 trellis init --dsh 的渲染产物（与写入项目的字节一致）， assets/scaffold/ 是 .trellis/ 模板镜像。上游模板更新后一并重新生成：

cd ../Trellis/packages/cli && pnpm build
cd ../../dsh-trellis && node scripts/prepare-assets.mjs   # 同步 skills + scaffold

与 Trellis 上游的配合

本插件完全自包含（运行时行为与 trellis init --dsh 等价，见上方对照表）。 此外，Trellis CLI（packages/cli）现已注册 dsh 平台：

• trellis init --dsh 会把同样的技能写入项目 .dsh/skills/，DSH 的文件系统 技能提供者会自动发现（项目级优先）——适合团队仓库共享标准；
• 插件侧提供命令、脚手架与会话体验，两者可同时使用，内容保持一致。

本项目是如何实现的

本项目（本插件 + Trellis 上游的 dsh 平台注册）完全由 DeepSeek V4 Flash （max reasoning effort）+ DeepSeek Harness (dsh) 会话完成，无人工手写代码：

• 设计：研究 DSH 的 Cordis 插件机制（ctx.skills / ctx.commands / systemPrompt.section / agent/created 事件）与 Trellis 的 14 平台集成架构 （AI_TOOLS 注册表 + configurator + 模板渲染），推导出 DSH 无 hook 场景下的 hook 等价注入方案；
• 实现：技能内容由 Trellis CLI 的渲染产物同步（prepare-assets.mjs）， 命令、脚手架、面包屑注入均在会话中编写；
• 上游合并：拉取落后 292 个提交，解决 7 处冲突（含上游新增 7 个平台）， 1672 个测试全绿后推送；
• 发布：GitHub CLI 建仓、topic、可见性配置均在本会话完成。

License

AGPL-3.0-only。技能内容与 .trellis/ 脚手架派生自 @mindfoldhq/trellis （AGPL-3.0），见 LICENSE。