Home / minleev5 / devkeel · .harness/skills/technical-design/SKILL.md · GitHub

technical-design skillA

technical-design is agent-read markdown (skill) from minleev5/devkeel: 将已确认需求和代码现状转成技术方案;可独立交付设计,或在 Brainstorming 中作为只读探针发现下一项高价值技术决定。.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 技术设计

产出能直接指导实现和验证的方案。

## 调用方契约

先识别调用模式:

- `probe`:由 Brainstorming 调用,只返回候选 gap 与证据,不向用户提问、不写文件、不生成设计;
- `deliverable`:用户明确要求独立技术设计时,按下述方法形成方案。

OpenSpec 下游 artifact 的投影阶段不得调用本 skill。design/specs/tasks 必须只投影已确认的 D-*、
A-*、仓库事实与机械拆分;发现新选择时退出投影并交回 Brainstorming。

- 调用方提供具体模板,或 artifact instruction 已明确标题、字段与顺序时,严格交付到该
  结构;不追加默认模板章节,不另建方案副本。
- 只有输出路径或设计约束、没有具体结构时,不视为已提供模板;按默认模板交付到指定位置。
- 复用当前 Agent 的热需求、调查和决策;上下文冷却、压缩、外部变更或关键事实不确定时,
  才重读必要输入。
- 只完成技术设计并返回调用方。不自动生成 tasks、启动 apply、调用其他专项 skill 或分派实现。
- 需求存在会改变范围或验收的空缺时,先交还需求分析,而不是用技术假设掩盖。

## Probe 输出契约

仅在 probe 模式按 Brainstorming 传入的讨论深度、目标与边界、已有决定、仓库依据和探查重点工作:

- Lite:围绕当前方案,定向检查可行性、实现边界、关键失败路径与验证缺口;
- Full:额外检查关键技术假设、合理替代路径、相关失败模式、兼容与维护代价;
- 未传深度时保持定向补缺;不自行切换讨论档位,不改变独立 deliverable 模式。

复用下文维度选择规则,Full 也只读取相关资料,不全量展开领域清单。只返回内部候选列表,每项
必须是一件可能改变实现结构、可观察行为或后续维护方式的决定,标明阻塞缺口或可选建议,并包含
仓库证据、当前猜测、影响与不确定性。
不输出设计文档、候选大全、覆盖矩阵或方法论摘要。

调用方会与需求 gap 合并去重,只向用户询问当前最高价值的一项。已有 D-* 覆盖、可由仓库事实
唯一确定或属于明确 A-* 自主范围的内容不算 gap;新证据揭示已确认决定存在冲突或风险时,指出
证据并交回 Brainstorming。可选建议不自动成为 O-* 或新范围;没有候选缺口时返回简短检查结论
与依据,不为了 Full 制造问题或替代方案。

## 输出结构优先级

1. 用户或调用方提供的具体模板优先。保留其标题、顺序、必填字段和格式;方法论只用于
   填充模板需要的内容。
2. artifact instruction 明确给出结构时,将其视为调用方模板;仅有目标、约束或输出路径时,
…

Read the whole file at its exact version.

How to install

Latest version
mdr add minleev5/devkeel/technical-design@v3.1.1
Exact content
mdr add minleev5/devkeel/technical-design@sha256:0fd6d7ba82234d72

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nkkmbyaokez6tfgt.svg)](https://markdownregistry.com/a/art_nkkmbyaokez6tfgt)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v3.1.1 latest2026-09-24 8bc6bbc 6,084 BA view · diff
v3.1.02026-09-24 82ce3b6 6,084 BA view · diff
v3.0.12026-09-22 123429c 5,327 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6084 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

minleev5/devkeel · 3 stars · license MIT · pushed 2026-09-24 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_nkkmbyaokez6tfgt
GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/technical-design
GET https://markdownregistry.com/api/v1/blob/0fd6d7ba82234d72968442cdc7085af7c2fc9a52fe3d7a4b0f1d049be0c4ad60

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from minleev5/devkeel

brainstorming skill
minleev5/devkeel · .harness/skills/brainstorming/SKILL.md · 探索、比较、挑战或补全开发方案;按 Lite/Full 深度进行单题访谈,并在用户同意持久化后维护 OpenSpec Living brainstorm。
v9.1.1 · audit A · 3 stars
changelog skill
minleev5/devkeel · .harness/skills/changelog/SKILL.md · Use when 编辑 changelog、发布 CLI 或模板版本、或判断某项用户可见变更是否需要进入版本记录。
v3.0.0 · audit A · 3 stars
commit skill
minleev5/devkeel · .harness/skills/commit/SKILL.md · 用户明确选择 commit、push 或 MR/PR 后使用的原子交付流程。任务完成或归档本身不触发;在授权范围内完成交付目标及其必要动作。
v1.2.4 · audit A · 3 stars
doc-maintenance skill
minleev5/devkeel · .harness/skills/doc-maintenance/SKILL.md · CLI 文档维护与一致性检查流程
v1.2.0 · audit A · 3 stars
domain-init skill
minleev5/devkeel · .harness/skills/domain-init/SKILL.md · 对项目进行全盘扫描,识别领域类型和技术栈,通过多 subAgent 并行扫描多维度, 生成项目知识 docs 与专属 rules、skills 和 agents。使用「自动 baseline + 交互式增强」…
v2.0.2 · audit A · 3 stars
health-check skill
minleev5/devkeel · .harness/skills/health-check/SKILL.md · 一键检查项目代码健康度指标
v1.0.0 · audit A · 3 stars
instruction-maintenance skill
minleev5/devkeel · .harness/skills/instruction-maintenance/SKILL.md · 精简并校验 AGENTS.md、OpenSpec schema/instruction、OPSX commands、SKILL.md、prompt 与 artifact 模板。用于审查当前 diff…
v1.0.0 · audit A · 3 stars
jira-defect-orchestrator skill
minleev5/devkeel · .harness/skills/jira-defect-orchestrator/SKILL.md · 独立编排 Jira 缺陷的取证、修复、验证、回填与 MR 交付,按决策风险确认。适用于用户提供 Jira URL 或 issue key,要求结合运行日志、配置、只读业务数据和代码证据处理生产或测试环境缺陷;普通无 Jira…
v1.3.2 · audit A · 3 stars
new-subcommand skill
minleev5/devkeel · .harness/skills/new-subcommand/SKILL.md · 为 DevKeel CLI 新增子命令的标准开发流程
v1.0.0 · audit A · 3 stars
openspec-apply-change skill
minleev5/devkeel · .harness/skills/openspec-apply-change/SKILL.md · 按 OpenSpec 动态 apply instruction 实施 change tasks,并处理 DevKeel 收尾门禁。
v3.2 · audit A · 3 stars
openspec-archive-change skill
minleev5/devkeel · .harness/skills/openspec-archive-change/SKILL.md · 检查完成状态、评估 spec sync,并按 schema 收尾门禁归档 OpenSpec change。
v3.3 · audit A · 3 stars
openspec-bulk-archive-change skill
minleev5/devkeel · .harness/skills/openspec-bulk-archive-change/SKILL.md · 批量检查 spec 冲突,并按 schema 门禁归档用户明确选择的多个 OpenSpec changes。
v2.2 · audit A · 3 stars

Every file in minleev5/devkeel

Browse by kind, by grade A, or by owner.