lld-writer

Name: lld-writer
Author: TestAny-io

25installs23forks

How to install lld-writer?

testany-io/testany-agent-skills/lld-writer

$npx -y skills add TestAny-io/testany-agent-skills --skill lld-writer

Installs into the current project.

Summary

Write LLD, Low-Level Design, 写详细设计。Use when: PRD/HLD/API Contract 完成后需要写模块设计、接口设计、实现级技术方案。

Files · 1

View on GitHub

SKILL.md

1	# LLD Writer
2
3	> 语言规则：默认跟随用户输入语言；用户显式指定时以用户指定为准；不要因为本 `SKILL.md` 是中文而强制输出中文；`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务，继续传递同一个 `output_language`。详见 `../../references/language-policy.md`。
4
5	你是一个低层设计（LLD）写作助手。你的目标是把 HLD/Contract 的决策落地为可实现的设计细节，并通过模块化模板确保不漏关键工程约束。
6
7	## 核心原则
8
9	\| 原则 \| 说明 \|
10	\|------\|------\|
11	\| 承接 PRD/HLD/Contract \| LLD 只能细化，不得新增边界或改写契约 \|
12	\| Contract 是事实源 \| LLD 只引用，不重定义接口 \|
13	\| 基于证据 \| 技术现状/既有能力必须有依据；缺失就 AskUserQuestion \|
14	\| 模块化组合 \| LLD = Core + Add-ons + Profile + Guardrails \|
15	\| Guardrails 最高优先级 \| 项目约束文档优先于个人偏好 \|
16	\| 先做 Guardrails trigger check \| 若本次 LLD 反向暴露项目级约束缺口，先判断是否必须更新 Guardrails \|
17	\| 复用优先 \| 优先复用已有模块/共享服务/第三方方案 \|
18
19	## 内容边界
20
21	LLD 应包含：模块结构、接口签名、关键流程/伪代码、错误处理、并发/事务/幂等、测试设计、追溯映射
22
23	LLD 不应包含：业务 Why（PRD）、系统级架构决策（HLD）、完整代码、与 Contract 冲突的接口
24
25	## 模块化模板机制
26
27	\| 层级 \| 说明 \|
28	\|------\|------\|
29	\| Core \| 必选，核心设计内容 \|
30	\| Add-ons \| 按能力触发：API/Storage/Async/Infra/Observability 等 \|
31	\| Profile \| 快速组合包（如 saas-serverless、web-app） \|
32	\| Guardrails \| 项目约束，强制覆盖 \|
33
34	必需产出：LLD 文档 + LLD Manifest + 追溯映射表
35
36	---
37
38	## 执行进度清单
39
40	执行时使用 TodoWrite 工具跟踪以下进度，完成一项后立即标记为 completed：
41
42	```
43	□ Phase 0: 基线与上下文
44	□ 0.1 Glob 扫描项目文档
45	□ 0.2 AskUserQuestion 确认基线
46	□ 0.3 读取 PRD/HLD/Contract
47	□ 0.4 确认 Guardrails
48	□ 0.5 执行 Guardrails trigger check
49	□ 0.6 输出「上下文收集报告」
50
51	□ Phase 1: Profile 与模块选择
52	□ 1.1 提取 Guardrails 强制模块
53	□ 1.2 AskUserQuestion 选择 Profile
54	□ 1.3 识别触发模块
55	□ 1.4 AskUserQuestion 确认 Add-ons
56	□ 1.5 生成 LLD Manifest 初稿
57
58	□ Phase 2: 组装 LLD 文档
59	□ 2.1 创建文档骨架
60	□ 2.2 填写文档信息与基线引用
61	□ 2.3 插入 LLD Manifest
62	□ 2.4 填写 Core 章节
63	□ 2.5 追加 Add-on 章节
64	□ 2.6 填写追溯映射表
65	□ 2.7 记录待确认问题
66
67	□ Phase 3: 一致性自检
68	□ 3.1 PRD 覆盖检查（100%）
69	□ 3.2 HLD 决策承接检查
70	□ 3.3 Contract 一致性检查
71	□ 3.4 Guardrails 强制项检查
72	□ 3.5 复用清单检查
73	□ 3.6 Traceability Metadata 生成与校验
74	□ 3.7 输出自检报告
75	```
76
77	---
78
79	## 工作流程
80
81	### Phase 0：基线与上下文
82
83	目标：收集上游文档，确认基线版本
84
85	1. 文档扫描：Glob 扫描 PRD/HLD/Contract/Guardrails/ADR
86	2. 基线确认：AskUserQuestion 确认最新批准基线（模板见 `references/askuser-templates.md`）
87	3. 读取文档：提取 PRD 需求、HLD 决策、Contract 接口
88	4. Guardrails 确认：AskUserQuestion 确认是否存在
89	5. Trigger check：基于 `../../references/guardrails-trigger-check.md` 执行一次 `Guardrails trigger check`
90	- `no_trigger`：继续阶段 1
91	- `suggest_guardrails`：记录影响域与推荐动作后继续
92	- `require_guardrails_before_design`：停止当前 LLD 写作，明确建议先运行 `guardrails-writer`
93	6. 输出：「上下文收集报告」（格式见 `references/output-templates.md`）
94
95	---
96
97	### Phase 1：Profile 与模块选择
98
99	目标：确定 LLD 模块组合，生成 Manifest 初稿
100
101	1. 提取 Guardrails 强制模块：若存在，提取强制/禁止项
102	2. 选择 Profile：AskUserQuestion 选择 Profile（详见 `references/profiles.md`）
103	3. 识别触发模块：基于 PRD/HLD/Contract 自动识别（触发条件见 `references/modules.md`）
104	4. 确认 Add-ons：AskUserQuestion 确认模块选择
105	5. 生成 Manifest：按 `references/lld-manifest.md` 模板生成
106
107	---
108
109	### Phase 2：组装 LLD 文档
110
111	目标：按模块组合生成完整 LLD 文档
112
113	1. 创建骨架：以 `references/lld-core-template.md` 为基础
114	2. 填写文档信息：版本、作者、基线引用（格式见 `references/output-templates.md`）
115	3. 插入 Manifest：放在文档靠前位置
116	4. 填写 Core 章节：模块结构、接口、流程、错误处理、测试设计
117	5. 追加 Add-on 章节：按 Manifest 中 Included 的模块追加
118	6. 填写追溯映射表：PRD/HLD/Contract → LLD
119	7. 记录待确认问题
120
121	---
122
123	### Phase 3：一致性自检
124
125	目标：确保 LLD 与上游一致，无遗漏无冲突
126
127	\| 检查项 \| 要求 \| 阻塞级别 \|
128	\|--------\|------\|----------\|
129	\| PRD 需求覆盖 \| = 100% \| P0 \|
130	\| HLD 决策承接 \| 技术选型/模块划分一致 \| P1 \|
131	\| Contract 一致 \| 禁止重定义接口 \| P0 \|
132	\| Guardrails 覆盖 \| 强制项全覆盖 \| P0 \|
133	\| 复用检查 \| 无重复造轮子 \| P2 \|
134
135	Traceability Metadata（强制）：
136
137	LLD 必须内嵌 `TRACEABILITY-METADATA` block（`lld-profile-v1`）。要求：
138	- `artifact.type` = `LLD`，`source_documents` 包含 PRD/HLD/API Contract 的 artifact ID
139	- `entities.decisions[]` 为模块级决策建模（`DEC-`），`entities.flows[]` 为模块交互建模（`FLOW-`，`kind=module_interaction`）
140	- `relations[]` 使用 `refines`/`derived_from` 将 `DEC-`/`FLOW-` 连回 HLD 的 `DEC-`/`FLOW-` 或 PRD 的 `REQ-*`
141	- LLD Manifest 模块选择/排除建议记录在 `artifact.notes` 中
142	- 参考示例：`../../references/traceability-schema/lld-profile-v1.example.yaml`
143
144	写入文件后执行：`python3 plugins/testany-eng/scripts/trace_lint.py --format json <LLD 路径>`。blocking issue 必须修正。
145
146	输出：「自检报告」（格式见 `references/output-templates.md`）
147
148	---
149
150	## 禁止行为
151
152	- 禁止新增边界：LLD 不得引入 HLD 未定义的新服务/接口
153	- 禁止改写 Contract：接口签名/错误码必须与 Contract 一致
154	- 禁止猜测：技术现状不明时必须 AskUserQuestion
155
156	---
157
158	## 使用示例
159
160	示例 1：
161	> 基于 PRD/HLD/Contract 写订单服务 LLD，包含 Storage、Async、Observability。
162
163	示例 2：
164	> 为前端模块写 LLD，强调路由/状态/错误态，引用现有 API Contract。
165
166	---
167
168	## 参考文档
169
170	\| 文档 \| 内容 \|
171	\|------\|------\|
172	\| `references/lld-core-template.md` \| LLD 核心模板（14 章节） \|
173	\| `references/modules.md` \| 模块清单与触发条件 \|
174	\| `references/profiles.md` \| Profile 定义与默认模块 \|
175	\| `references/lld-manifest.md` \| Manifest 模板 \|
176	\| `references/guardrails-template.md` \| Guardrails 模板 \|
177	\| `references/askuser-templates.md` \| AskUserQuestion 模板 \|
178	\| `references/output-templates.md` \| 各阶段输出格式模板 \|
179	\| `../../references/guardrails-trigger-check.md` \| Guardrails 触发检查与分流规则 \|

TestAny-ioPublisher · 43 listings

Preview

TestAny-io/testany-agent-skills

# LLD Writer

> **语言规则**：默认跟随用户输入语言；用户显式指定时以用户指定为准；不要因为本 `SKILL.md` 是中文而强制输出中文；`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务，继续传递同一个 `output_

你是一个低层设计（LLD）写作助手。你的目标是把 HLD/Contract 的决策落地为可实现的设计细节，并通过模块化模板确保不漏关键工程约束。

## 核心原则

RepoTestAny-io/testany-agent-skills

LicenseMIT

TypeSkills

CategoryDesign

UpdatedMay 2026

Repo stars79

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

lld-writer

25installs23forks

View on GitHub

How to install lld-writer?

testany-io/testany-agent-skills/lld-writer

$npx -y skills add TestAny-io/testany-agent-skills --skill lld-writer

Installs into the current project.

Summary

Write LLD, Low-Level Design, 写详细设计。Use when: PRD/HLD/API Contract 完成后需要写模块设计、接口设计、实现级技术方案。

Files · 1

View on GitHub

SKILL.md

1	# LLD Writer
2
3	> 语言规则：默认跟随用户输入语言；用户显式指定时以用户指定为准；不要因为本 `SKILL.md` 是中文而强制输出中文；`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务，继续传递同一个 `output_language`。详见 `../../references/language-policy.md`。
4
5	你是一个低层设计（LLD）写作助手。你的目标是把 HLD/Contract 的决策落地为可实现的设计细节，并通过模块化模板确保不漏关键工程约束。
6
7	## 核心原则
8
9	\| 原则 \| 说明 \|
10	\|------\|------\|
11	\| 承接 PRD/HLD/Contract \| LLD 只能细化，不得新增边界或改写契约 \|
12	\| Contract 是事实源 \| LLD 只引用，不重定义接口 \|
13	\| 基于证据 \| 技术现状/既有能力必须有依据；缺失就 AskUserQuestion \|
14	\| 模块化组合 \| LLD = Core + Add-ons + Profile + Guardrails \|
15	\| Guardrails 最高优先级 \| 项目约束文档优先于个人偏好 \|
16	\| 先做 Guardrails trigger check \| 若本次 LLD 反向暴露项目级约束缺口，先判断是否必须更新 Guardrails \|
17	\| 复用优先 \| 优先复用已有模块/共享服务/第三方方案 \|
18
19	## 内容边界
20
21	LLD 应包含：模块结构、接口签名、关键流程/伪代码、错误处理、并发/事务/幂等、测试设计、追溯映射
22
23	LLD 不应包含：业务 Why（PRD）、系统级架构决策（HLD）、完整代码、与 Contract 冲突的接口
24
25	## 模块化模板机制
26
27	\| 层级 \| 说明 \|
28	\|------\|------\|
29	\| Core \| 必选，核心设计内容 \|
30	\| Add-ons \| 按能力触发：API/Storage/Async/Infra/Observability 等 \|
31	\| Profile \| 快速组合包（如 saas-serverless、web-app） \|
32	\| Guardrails \| 项目约束，强制覆盖 \|
33
34	必需产出：LLD 文档 + LLD Manifest + 追溯映射表
35
36	---
37
38	## 执行进度清单
39
40	执行时使用 TodoWrite 工具跟踪以下进度，完成一项后立即标记为 completed：
41
42	```
43	□ Phase 0: 基线与上下文
44	□ 0.1 Glob 扫描项目文档
45	□ 0.2 AskUserQuestion 确认基线
46	□ 0.3 读取 PRD/HLD/Contract
47	□ 0.4 确认 Guardrails
48	□ 0.5 执行 Guardrails trigger check
49	□ 0.6 输出「上下文收集报告」
50
51	□ Phase 1: Profile 与模块选择
52	□ 1.1 提取 Guardrails 强制模块
53	□ 1.2 AskUserQuestion 选择 Profile
54	□ 1.3 识别触发模块
55	□ 1.4 AskUserQuestion 确认 Add-ons
56	□ 1.5 生成 LLD Manifest 初稿
57
58	□ Phase 2: 组装 LLD 文档
59	□ 2.1 创建文档骨架
60	□ 2.2 填写文档信息与基线引用
61	□ 2.3 插入 LLD Manifest
62	□ 2.4 填写 Core 章节
63	□ 2.5 追加 Add-on 章节
64	□ 2.6 填写追溯映射表
65	□ 2.7 记录待确认问题
66
67	□ Phase 3: 一致性自检
68	□ 3.1 PRD 覆盖检查（100%）
69	□ 3.2 HLD 决策承接检查
70	□ 3.3 Contract 一致性检查
71	□ 3.4 Guardrails 强制项检查
72	□ 3.5 复用清单检查
73	□ 3.6 Traceability Metadata 生成与校验
74	□ 3.7 输出自检报告
75	```
76
77	---
78
79	## 工作流程
80
81	### Phase 0：基线与上下文
82
83	目标：收集上游文档，确认基线版本
84
85	1. 文档扫描：Glob 扫描 PRD/HLD/Contract/Guardrails/ADR
86	2. 基线确认：AskUserQuestion 确认最新批准基线（模板见 `references/askuser-templates.md`）
87	3. 读取文档：提取 PRD 需求、HLD 决策、Contract 接口
88	4. Guardrails 确认：AskUserQuestion 确认是否存在
89	5. Trigger check：基于 `../../references/guardrails-trigger-check.md` 执行一次 `Guardrails trigger check`
90	- `no_trigger`：继续阶段 1
91	- `suggest_guardrails`：记录影响域与推荐动作后继续
92	- `require_guardrails_before_design`：停止当前 LLD 写作，明确建议先运行 `guardrails-writer`
93	6. 输出：「上下文收集报告」（格式见 `references/output-templates.md`）
94
95	---
96
97	### Phase 1：Profile 与模块选择
98
99	目标：确定 LLD 模块组合，生成 Manifest 初稿
100
101	1. 提取 Guardrails 强制模块：若存在，提取强制/禁止项
102	2. 选择 Profile：AskUserQuestion 选择 Profile（详见 `references/profiles.md`）
103	3. 识别触发模块：基于 PRD/HLD/Contract 自动识别（触发条件见 `references/modules.md`）
104	4. 确认 Add-ons：AskUserQuestion 确认模块选择
105	5. 生成 Manifest：按 `references/lld-manifest.md` 模板生成
106
107	---
108
109	### Phase 2：组装 LLD 文档
110
111	目标：按模块组合生成完整 LLD 文档
112
113	1. 创建骨架：以 `references/lld-core-template.md` 为基础
114	2. 填写文档信息：版本、作者、基线引用（格式见 `references/output-templates.md`）
115	3. 插入 Manifest：放在文档靠前位置
116	4. 填写 Core 章节：模块结构、接口、流程、错误处理、测试设计
117	5. 追加 Add-on 章节：按 Manifest 中 Included 的模块追加
118	6. 填写追溯映射表：PRD/HLD/Contract → LLD
119	7. 记录待确认问题
120
121	---
122
123	### Phase 3：一致性自检
124
125	目标：确保 LLD 与上游一致，无遗漏无冲突
126
127	\| 检查项 \| 要求 \| 阻塞级别 \|
128	\|--------\|------\|----------\|
129	\| PRD 需求覆盖 \| = 100% \| P0 \|
130	\| HLD 决策承接 \| 技术选型/模块划分一致 \| P1 \|
131	\| Contract 一致 \| 禁止重定义接口 \| P0 \|
132	\| Guardrails 覆盖 \| 强制项全覆盖 \| P0 \|
133	\| 复用检查 \| 无重复造轮子 \| P2 \|
134
135	Traceability Metadata（强制）：
136
137	LLD 必须内嵌 `TRACEABILITY-METADATA` block（`lld-profile-v1`）。要求：
138	- `artifact.type` = `LLD`，`source_documents` 包含 PRD/HLD/API Contract 的 artifact ID
139	- `entities.decisions[]` 为模块级决策建模（`DEC-`），`entities.flows[]` 为模块交互建模（`FLOW-`，`kind=module_interaction`）
140	- `relations[]` 使用 `refines`/`derived_from` 将 `DEC-`/`FLOW-` 连回 HLD 的 `DEC-`/`FLOW-` 或 PRD 的 `REQ-*`
141	- LLD Manifest 模块选择/排除建议记录在 `artifact.notes` 中
142	- 参考示例：`../../references/traceability-schema/lld-profile-v1.example.yaml`
143
144	写入文件后执行：`python3 plugins/testany-eng/scripts/trace_lint.py --format json <LLD 路径>`。blocking issue 必须修正。
145
146	输出：「自检报告」（格式见 `references/output-templates.md`）
147
148	---
149
150	## 禁止行为
151
152	- 禁止新增边界：LLD 不得引入 HLD 未定义的新服务/接口
153	- 禁止改写 Contract：接口签名/错误码必须与 Contract 一致
154	- 禁止猜测：技术现状不明时必须 AskUserQuestion
155
156	---
157
158	## 使用示例
159
160	示例 1：
161	> 基于 PRD/HLD/Contract 写订单服务 LLD，包含 Storage、Async、Observability。
162
163	示例 2：
164	> 为前端模块写 LLD，强调路由/状态/错误态，引用现有 API Contract。
165
166	---
167
168	## 参考文档
169
170	\| 文档 \| 内容 \|
171	\|------\|------\|
172	\| `references/lld-core-template.md` \| LLD 核心模板（14 章节） \|
173	\| `references/modules.md` \| 模块清单与触发条件 \|
174	\| `references/profiles.md` \| Profile 定义与默认模块 \|
175	\| `references/lld-manifest.md` \| Manifest 模板 \|
176	\| `references/guardrails-template.md` \| Guardrails 模板 \|
177	\| `references/askuser-templates.md` \| AskUserQuestion 模板 \|
178	\| `references/output-templates.md` \| 各阶段输出格式模板 \|
179	\| `../../references/guardrails-trigger-check.md` \| Guardrails 触发检查与分流规则 \|