Public Access
ZLH
766d3eb0b0
- package.json 声明 dsh.bundle 与 dsh 引擎范围，供 DSH 作为 bundle 安装 - cordis.patch.yml 与 lib/index.js 注册只指向本包 skills 目录的技能提供方 - index.json 提供 format 1 市场索引，DSH 可通过索引地址发现并安装 - README 补充 DSH 安装方式与三处版本号的同步说明
2.1 KiB
2.1 KiB
工程协作约定
一套与具体工具无关的 AI 编码协作约定，适用于任何 AI 编码助手（Claude Code、Codex、Copilot、DeepSeek Harness 等）与人工协作的场景。
内容涵盖：动手前先找现成实现、公共代码与多文件改动先对齐、改实现同轮改文档、最小验证、长时间任务汇报进度、规范的提交信息与代码文风。
内容
| 文件 | 说明 |
|---|---|
skills/engineering-conventions/SKILL.md |
约定正文：工作方式、动手前先对齐、执行与验证、上下文成本、Git、代码文风 |
index.json |
DeepSeek Harness 市场索引（format 1） |
package.json、cordis.patch.yml、lib/index.js |
DeepSeek Harness bundle 声明与技能提供方接线 |
.claude-plugin/plugin.json |
Claude Code 插件清单 |
SKILL.md 是纯 Markdown，可以直接阅读，也可以作为任意 AI 助手的指令文件（system prompt、规则文件、技能条目都适用）。
在 DeepSeek Harness 中安装
DSH 不自带任何市场源，需要在 Plugins 页开启实验功能 “Custom plugin indexes”，然后在 Discover → Add index source 里填索引地址：
https://www.zlhhh.com/ZLH/engineering-conventions/raw/branch/main/index.json
索引条目按 git commit 固定版本安装，版本号与 commit 记录在 index.json 的 versions 中。
作为 Claude Code 插件安装
本仓库同时符合 Claude Code 插件格式（.claude-plugin/plugin.json + skills/），需要时可直接装成插件：
claude plugin marketplace add https://www.zlhhh.com/ZLH/engineering-conventions.git
claude plugin install engineering-conventions@engineering-conventions
桌面应用可在「添加插件 → Git URL」填上面的仓库地址，再从市场安装。
版本
同一份版本号记在三处，改动技能内容后一起递增：
package.json的version（DSH bundle）.claude-plugin/plugin.json的version（Claude Code 插件）index.json里的versions条目（DSH 市场索引，需同时更新commit为提交后的完整 SHA 与publishTimestamp）
许可
MIT