cgraphx 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/README.md +0 -1
  2. package/dist/.claude-template/skills/cgraphx/SKILL.md +3 -3
  3. package/dist/.claude-template/skills/cgraphx/agent-prompt.md +1 -1
  4. package/dist/.claude-template/skills/cgraphx-guide/SKILL.md +94 -0
  5. package/dist/.claude-template/skills/cgraphx-guide/how-to-use.html +403 -0
  6. package/dist/.claude-template/skills/clarify-requirements/SKILL.md +19 -8
  7. package/dist/.claude-template/skills/code-impact-docgen/SKILL.md +186 -176
  8. package/dist/.claude-template/skills/code-impact-docgen/template-design-html.md +357 -0
  9. package/dist/.claude-template/skills/code-impact-docgen/template-design-md.md +164 -0
  10. package/dist/.claude-template/skills/code-impact-init/SKILL.md +47 -47
  11. package/dist/.claude-template/skills/developer-timeline/SKILL.md +9 -0
  12. package/dist/.claude-template/skills/write-api-doc/SKILL.md +317 -0
  13. package/dist/.claude-template/skills/write-api-doc/template-api-html.md +422 -0
  14. package/dist/.claude-template/skills/write-plan/SKILL.md +38 -16
  15. package/dist/.claude-template/skills/write-prd/SKILL.md +32 -8
  16. package/dist/.claude-template/skills/write-spec/SKILL.md +34 -9
  17. package/dist/bin/codegraph.js +0 -100
  18. package/dist/bin/codegraph.js.map +1 -1
  19. package/dist/resolution/index.d.ts.map +1 -1
  20. package/dist/resolution/index.js +13 -0
  21. package/dist/resolution/index.js.map +1 -1
  22. package/dist/resolution/scope-index.d.ts +86 -0
  23. package/dist/resolution/scope-index.d.ts.map +1 -0
  24. package/dist/resolution/scope-index.js +143 -0
  25. package/dist/resolution/scope-index.js.map +1 -0
  26. package/dist/resolution/stdlib-blocklist.d.ts +53 -0
  27. package/dist/resolution/stdlib-blocklist.d.ts.map +1 -0
  28. package/dist/resolution/stdlib-blocklist.js +143 -0
  29. package/dist/resolution/stdlib-blocklist.js.map +1 -0
  30. package/dist/search/ast-helpers.d.ts +42 -0
  31. package/dist/search/ast-helpers.d.ts.map +1 -0
  32. package/dist/search/ast-helpers.js +106 -0
  33. package/dist/search/ast-helpers.js.map +1 -0
  34. package/dist/search/call-sites.d.ts +398 -0
  35. package/dist/search/call-sites.d.ts.map +1 -0
  36. package/dist/search/call-sites.js +1433 -0
  37. package/dist/search/call-sites.js.map +1 -0
  38. package/dist/search/context.d.ts +134 -0
  39. package/dist/search/context.d.ts.map +1 -0
  40. package/dist/search/context.js +575 -0
  41. package/dist/search/context.js.map +1 -0
  42. package/dist/search/impact.d.ts +139 -0
  43. package/dist/search/impact.d.ts.map +1 -0
  44. package/dist/search/impact.js +646 -0
  45. package/dist/search/impact.js.map +1 -0
  46. package/dist/search/related.d.ts +178 -0
  47. package/dist/search/related.d.ts.map +1 -0
  48. package/dist/search/related.js +667 -0
  49. package/dist/search/related.js.map +1 -0
  50. package/dist/search/slice.d.ts +148 -0
  51. package/dist/search/slice.d.ts.map +1 -0
  52. package/dist/search/slice.js +460 -0
  53. package/dist/search/slice.js.map +1 -0
  54. package/dist/search/snr-constants.d.ts +41 -0
  55. package/dist/search/snr-constants.d.ts.map +1 -0
  56. package/dist/search/snr-constants.js +44 -0
  57. package/dist/search/snr-constants.js.map +1 -0
  58. package/dist/search/types.d.ts +28 -0
  59. package/dist/search/types.d.ts.map +1 -0
  60. package/dist/search/types.js +12 -0
  61. package/dist/search/types.js.map +1 -0
  62. package/dist/timeline/cli.d.ts.map +1 -1
  63. package/dist/timeline/cli.js +22 -3
  64. package/dist/timeline/cli.js.map +1 -1
  65. package/dist/timeline/store.d.ts +5 -0
  66. package/dist/timeline/store.d.ts.map +1 -1
  67. package/dist/timeline/store.js +23 -3
  68. package/dist/timeline/store.js.map +1 -1
  69. package/package.json +1 -1
  70. package/scripts/agent-eval/block-cgraphx-and-gitnexus-cli-hook.sh +43 -0
  71. package/scripts/agent-eval/block-cgraphx-cli-hook.sh +32 -0
  72. package/scripts/agent-eval/block-cgraphx-cli-settings.json +16 -0
  73. package/scripts/agent-eval/cli-vs-mcp-3arm.sh +121 -0
  74. package/scripts/agent-eval/multi-tool-eval.sh +171 -0
  75. package/scripts/agent-eval/parse-cli-vs-mcp.mjs +232 -0
  76. package/scripts/agent-eval/parse-multi-tool.mjs +242 -0
  77. package/scripts/agent-eval/subagent-token-cost.py +188 -0
  78. package/dist/.claude-template/skills/code-impact-docgen/template-business-html.md +0 -242
  79. package/dist/.claude-template/skills/code-impact-docgen/template-business-md.md +0 -107
  80. package/dist/.claude-template/skills/code-impact-docgen/template-technical-html.md +0 -205
  81. package/dist/.claude-template/skills/code-impact-docgen/template-technical-md.md +0 -155
package/dist/.claude-template/skills/code-impact-docgen/template-design-html.md ADDED
@@ -0,0 +1,357 @@
1
+ # 设计文档 HTML 模板
2
+
3
+ 适用于 feature 实现完成后沉淀的设计文档,面向研发、技术负责人和后续维护者。由 `code-impact-docgen` skill 在自测通过后生成,默认输出到 `docs/features/<feature-id>/<文件前缀>-设计文档.md`(HTML 内容嵌入 markdown 文件,或直接 `.html`)。
4
+
5
+ 内容来源:`docs/knowledge/` 中与主题相关的 AI 知识文档 + 当前 feature 目录下的 spec/plan。
6
+
7
+ ## 完整 HTML 结构
8
+
9
+ ```html
10
+ <!DOCTYPE html>
11
+ <html lang="zh-CN">
12
+ <head>
13
+ <meta charset="UTF-8">
14
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
15
+ <title>{文档标题} — {项目名称}</title>
16
+ <style>
17
+ :root {
18
+ --bg: #ffffff;
19
+ --surface: #f8f9fa;
20
+ --text: #1d1d1f;
21
+ --text-secondary: #6e6e73;
22
+ --accent: #0071e3;
23
+ --accent-light: #e8f0fe;
24
+ --border: #d2d2d7;
25
+ --code-bg: #f5f5f7;
26
+ --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
27
+ --font-mono: "SF Mono", "Fira Code", "Cascadia Code", "Source Code Pro", monospace;
28
+ --max-width: 800px;
29
+ }
30
+
31
+ *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
32
+
33
+ body {
34
+ font-family: var(--font-sans);
35
+ font-size: 16px;
36
+ line-height: 1.7;
37
+ color: var(--text);
38
+ background: var(--bg);
39
+ }
40
+
41
+ .container {
42
+ max-width: var(--max-width);
43
+ margin: 0 auto;
44
+ padding: 2rem 1.5rem;
45
+ }
46
+
47
+ h1 {
48
+ font-size: 2rem;
49
+ font-weight: 700;
50
+ letter-spacing: -0.02em;
51
+ margin-bottom: 0.5em;
52
+ padding-bottom: 0.5em;
53
+ border-bottom: 2px solid var(--border);
54
+ }
55
+
56
+ .meta {
57
+ color: var(--text-secondary);
58
+ font-size: 0.875rem;
59
+ margin-bottom: 2em;
60
+ }
61
+
62
+ h2 {
63
+ font-size: 1.5rem;
64
+ font-weight: 600;
65
+ margin-top: 2.5em;
66
+ margin-bottom: 0.75em;
67
+ padding-bottom: 0.3em;
68
+ border-bottom: 1px solid var(--border);
69
+ }
70
+
71
+ h3 {
72
+ font-size: 1.2rem;
73
+ font-weight: 600;
74
+ margin-top: 1.5em;
75
+ margin-bottom: 0.5em;
76
+ }
77
+
78
+ p { margin-bottom: 1em; }
79
+
80
+ ul, ol {
81
+ margin-bottom: 1em;
82
+ padding-left: 1.5em;
83
+ }
84
+
85
+ li { margin-bottom: 0.3em; }
86
+
87
+ strong { font-weight: 600; }
88
+
89
+ code {
90
+ font-family: var(--font-mono);
91
+ background: var(--code-bg);
92
+ padding: 0.15em 0.4em;
93
+ border-radius: 4px;
94
+ font-size: 0.9em;
95
+ }
96
+
97
+ pre {
98
+ background: var(--code-bg);
99
+ border: 1px solid var(--border);
100
+ border-radius: 8px;
101
+ padding: 1em;
102
+ margin-bottom: 1em;
103
+ overflow-x: auto;
104
+ }
105
+
106
+ pre code {
107
+ background: none;
108
+ padding: 0;
109
+ font-size: 0.875em;
110
+ }
111
+
112
+ table {
113
+ width: 100%;
114
+ border-collapse: collapse;
115
+ margin-bottom: 1em;
116
+ font-size: 0.95em;
117
+ }
118
+
119
+ th, td {
120
+ padding: 0.6em 1em;
121
+ text-align: left;
122
+ border-bottom: 1px solid var(--border);
123
+ }
124
+
125
+ thead th {
126
+ font-weight: 600;
127
+ color: var(--accent);
128
+ background: var(--surface);
129
+ }
130
+
131
+ tbody tr:nth-child(even) { background: var(--surface); }
132
+
133
+ .toc {
134
+ background: var(--surface);
135
+ border: 1px solid var(--border);
136
+ border-radius: 8px;
137
+ padding: 1em 1.5em;
138
+ margin-bottom: 2em;
139
+ }
140
+
141
+ .toc h3 {
142
+ margin-top: 0;
143
+ margin-bottom: 0.5em;
144
+ font-size: 1rem;
145
+ }
146
+
147
+ .toc ul { list-style: none; padding-left: 0; }
148
+ .toc li { margin-bottom: 0.25em; }
149
+ .toc a { color: var(--accent); text-decoration: none; }
150
+ .toc a:hover { text-decoration: underline; }
151
+ .toc ul ul { padding-left: 1.5em; margin-top: 0.25em; }
152
+
153
+ .callout {
154
+ background: var(--accent-light);
155
+ border-left: 4px solid var(--accent);
156
+ padding: 0.75em 1em;
157
+ border-radius: 0 8px 8px 0;
158
+ margin-bottom: 1em;
159
+ }
160
+
161
+ .diagram {
162
+ background: var(--surface);
163
+ border: 1px solid var(--border);
164
+ border-radius: 8px;
165
+ padding: 1.5em;
166
+ margin-bottom: 1em;
167
+ font-family: var(--font-mono);
168
+ font-size: 0.875em;
169
+ white-space: pre;
170
+ overflow-x: auto;
171
+ line-height: 1.5;
172
+ }
173
+
174
+ .tag {
175
+ display: inline-block;
176
+ font-size: 0.8em;
177
+ background: var(--accent-light);
178
+ color: var(--accent);
179
+ border: 1px solid rgba(0, 113, 227, 0.2);
180
+ padding: 0.15em 0.6em;
181
+ border-radius: 12px;
182
+ }
183
+
184
+ .api-method {
185
+ font-family: var(--font-mono);
186
+ font-weight: 600;
187
+ }
188
+
189
+ .decision-block {
190
+ background: var(--surface);
191
+ border: 1px solid var(--border);
192
+ border-radius: 8px;
193
+ padding: 1em 1.5em;
194
+ margin-bottom: 1em;
195
+ }
196
+
197
+ .decision-block h4 {
198
+ margin-top: 0;
199
+ margin-bottom: 0.5em;
200
+ color: var(--accent);
201
+ }
202
+
203
+ .decision-block dl {
204
+ display: grid;
205
+ grid-template-columns: auto 1fr;
206
+ gap: 0.3em 1em;
207
+ font-size: 0.95em;
208
+ }
209
+
210
+ .decision-block dt {
211
+ font-weight: 600;
212
+ color: var(--text-secondary);
213
+ }
214
+
215
+ .decision-block dd {
216
+ margin: 0;
217
+ }
218
+
219
+ .limit-table td:first-child {
220
+ white-space: nowrap;
221
+ font-weight: 600;
222
+ color: var(--text-secondary);
223
+ }
224
+
225
+ @media print {
226
+ body { font-size: 12pt; }
227
+ .container { max-width: 100%; padding: 0; }
228
+ .toc { break-after: page; }
229
+ h2 { break-after: avoid; }
230
+ }
231
+ </style>
232
+ </head>
233
+ <body>
234
+ <div class="container">
235
+ <h1>{文档标题}</h1>
236
+ <p class="meta">生成日期：YYYY-MM-DD | 主题范围：{范围描述} | feature-id: {feature-id}</p>
237
+
238
+ <nav class="toc">
239
+ <h3>目录</h3>
240
+ <ul>
241
+ <li><a href="#概述">概述</a></li>
242
+ <li><a href="#架构设计">架构设计</a></li>
243
+ <li><a href="#核心模块">核心模块</a>
244
+ <ul>
245
+ <li><a href="#模块A">模块 A</a></li>
246
+ <li><a href="#模块B">模块 B</a></li>
247
+ </ul>
248
+ </li>
249
+ <li><a href="#技术决策">技术决策</a></li>
250
+ <li><a href="#已知限制">已知限制</a></li>
251
+ <li><a href="#扩展方向">扩展方向</a></li>
252
+ </ul>
253
+ </nav>
254
+
255
+ <article>
256
+ <section id="概述">
257
+ <h2>概述</h2>
258
+ <p>系统概述和技术定位。来源:spec 目标与范围 + knowledge Summary。</p>
259
+ </section>
260
+
261
+ <section id="架构设计">
262
+ <h2>架构设计</h2>
263
+ <p>系统架构和数据流描述。来源:spec 系统行为/接口边界 + knowledge Summary + Read 原文。</p>
264
+ <pre class="diagram">组件 A ──→ 组件 B ──→ 组件 C
265
+ │
266
+ ↕
267
+ 外部服务</pre>
268
+ </section>
269
+
270
+ <section id="核心模块">
271
+ <h2>核心模块</h2>
272
+
273
+ <section id="模块A">
274
+ <h3>模块 A</h3>
275
+ <p>职责描述和关键接口。来源:plan 任务拆分 + knowledge Summary。</p>
276
+ </section>
277
+
278
+ <section id="模块B">
279
+ <h3>模块 B</h3>
280
+ <p>职责描述和关键接口。</p>
281
+ </section>
282
+ </section>
283
+
284
+ <section id="技术决策">
285
+ <h2>技术决策</h2>
286
+ <div class="decision-block">
287
+ <h4>决策标题</h4>
288
+ <dl>
289
+ <dt>选择</dt>
290
+ <dd>xxx</dd>
291
+ <dt>原因</dt>
292
+ <dd>xxx</dd>
293
+ <dt>替代方案</dt>
294
+ <dd>xxx</dd>
295
+ </dl>
296
+ </div>
297
+ <p>来源:spec 不可留实现期决策 + knowledge Decisions。</p>
298
+ </section>
299
+
300
+ <section id="已知限制">
301
+ <h2>已知限制</h2>
302
+ <table class="limit-table">
303
+ <thead>
304
+ <tr><th>限制</th><th>影响范围</th><th>应对措施</th></tr>
305
+ </thead>
306
+ <tbody>
307
+ <tr><td>限制描述</td><td>影响范围</td><td>应对措施</td></tr>
308
+ </tbody>
309
+ </table>
310
+ <p>来源:spec 待确认项 + knowledge Findings/Risks。</p>
311
+ </section>
312
+
313
+ <section id="扩展方向">
314
+ <h2>扩展方向</h2>
315
+ <ol>
316
+ <li><strong>方向 A</strong> — 描述和优先级</li>
317
+ <li><strong>方向 B</strong> — 描述和优先级</li>
318
+ </ol>
319
+ <p>来源:knowledge Outlook。</p>
320
+ </section>
321
+ </article>
322
+ </div>
323
+ </body>
324
+ </html>
325
+ ```
326
+
327
+ ## 设计文档 HTML 章节内容指南
328
+
329
+ | 章节 | 主来源 | 辅来源 | 改写方向 |
330
+ |------|------------------------|----------|----------|
331
+ | 概述 | spec 目标与范围 | knowledge Summary | 保留技术精确度,增加架构上下文 |
332
+ | 架构设计 | spec 系统行为/接口边界 | knowledge Summary + Read 原文 | 补充系统级架构图(文本框图)、数据流描述 |
333
+ | 核心模块 | plan 任务拆分 | knowledge Summary | 按模块分组,说明职责和交互关系 |
334
+ | 数据模型 | plan schema 任务 | spec 数据口径 + Read 原文 | 用表格展示节点类型、属性、关系 |
335
+ | 技术决策 | spec 不可留实现期决策 | knowledge Decisions + Read 原文 | 保留决策理由,补充替代方案对比 |
336
+ | API 参考 | spec 接口边界 | plan backend 任务 + Read 原文 | 按 endpoint 分组,包含请求/响应示例 |
337
+ | 性能特征 | knowledge Findings | Read 原文 | 用表格展示瓶颈和优化方向 |
338
+ | 已知限制 | spec 待确认项 | knowledge Findings/Risks + Read 原文 | 按严重程度排序,说明影响范围 |
339
+ | 扩展方向 | knowledge Outlook | Read 原文 | 按优先级排序,说明实现复杂度 |
340
+ | 运维指南 | knowledge Operations | Read 原文 | 按"部署 / 监控 / 排障"分组 |
341
+
342
+ ## HTML 格式要点
343
+
344
+ - 所有 CSS 内联在 `<style>` 标签中,不引用外部样式表
345
+ - `<title>` 包含文档标题和项目名称
346
+ - 使用 `<nav class="toc">` 作为目录容器
347
+ - 每个章节使用 `<section id="章节锚点">` 包裹
348
+ - 章节锚点使用中文 ID(如 `id="架构设计"`)
349
+ - 重要提示或注意事项使用 `<div class="callout">` 样式
350
+ - 代码示例使用 `<pre><code>` 标签
351
+ - 表格使用 `<thead>` + `<tbody>` 结构
352
+ - 架构图使用 `<pre class="diagram">` 包裹 ASCII 文本框图
353
+ - 技术决策使用 `<div class="decision-block">` 结构,包含 `<dl>` 列表
354
+ - 已知限制使用表格,按严重程度降序排列
355
+ - 模块描述使用 `<section id="模块名">` + `<h3>` 子标题
356
+ - API 端点使用 `<span class="api-method">GET</span>` 标注 HTTP 方法
357
+ - 技术标签使用 `<span class="tag">标签名</span>` 样式
package/dist/.claude-template/skills/code-impact-docgen/template-design-md.md ADDED
@@ -0,0 +1,164 @@
1
+ # 设计文档 Markdown 模板
2
+
3
+ 适用于 feature 实现完成后沉淀的设计文档,面向研发、技术负责人和后续维护者。由 `code-impact-docgen` skill 在自测通过后生成,默认输出到 `docs/features/<feature-id>/<文件前缀>-设计文档.md`。
4
+
5
+ 内容来源:`docs/knowledge/` 中与主题相关的 AI 知识文档 + 当前 feature 目录下的 spec/plan。
6
+
7
+ ## 文档结构
8
+
9
+ ```markdown
10
+ # {文档标题}
11
+
12
+ > 生成日期：YYYY-MM-DD | 主题范围：{范围描述} | feature-id: {feature-id}
13
+
14
+ ## 目录
15
+
16
+ - [概述](#概述)
17
+ - [架构设计](#架构设计)
18
+ - [核心模块](#核心模块)
19
+ - [模块 A](#模块-a)
20
+ - [模块 B](#模块-b)
21
+ - [技术决策](#技术决策)
22
+ - [已知限制](#已知限制)
23
+ - [扩展方向](#扩展方向)
24
+
25
+ ## 概述
26
+
27
+ 系统概述和技术定位。来源:spec 的目标与范围 + knowledge Summary。
28
+
29
+ ## 架构设计
30
+
31
+ 系统架构和数据流描述。来源:spec 的系统行为/接口边界 + knowledge Summary + Read 文件原文。
32
+
33
+ ```
34
+ 组件 A ──→ 组件 B ──→ 组件 C
35
+ │
36
+ ↕
37
+ 外部服务
38
+ ```
39
+
40
+ ## 核心模块
41
+
42
+ ### 模块 A
43
+
44
+ 职责描述、关键接口和依赖关系。来源:plan 的任务拆分 + knowledge Summary。
45
+
46
+ ### 模块 B
47
+
48
+ 职责描述、关键接口和依赖关系。
49
+
50
+ ## 技术决策
51
+
52
+ ### 决策标题
53
+
54
+ - **选择**：xxx
55
+ - **原因**：xxx
56
+ - **替代方案**：xxx
57
+
58
+ 来源:spec 的"不可留到实现期的决策" + knowledge 中的 Decisions 章节。
59
+
60
+ ## 已知限制
61
+
62
+ | 限制 | 影响范围 | 应对措施 |
63
+ |------|----------|----------|
64
+ | 限制描述 | 影响范围 | 应对措施 |
65
+
66
+ 来源:spec 的"待确认项" + knowledge 中的 Findings / Risks 章节。
67
+
68
+ ## 扩展方向
69
+
70
+ 1. **方向 A** — 描述和优先级
71
+ 2. **方向 B** — 描述和优先级
72
+ ```
73
+
74
+ ## 可选章节（按需插入）
75
+
76
+ ```markdown
77
+ ## 数据模型
78
+
79
+ | 类型 | 属性 | 关系 |
80
+ |------|------|------|
81
+ | 节点类型 A | 属性列表 | 关系列表 |
82
+
83
+ 来源:spec 的"数据、状态与口径" + plan 的 schema 任务 + knowledge 的 Data Model 章节。
84
+
85
+ ## API 参考
86
+
87
+ ### 端点名称
88
+
89
+ `POST /api/path`
90
+
91
+ **请求参数**：
92
+
93
+ | 参数 | 类型 | 说明 |
94
+ |------|------|------|
95
+ | param | string | 说明 |
96
+
97
+ **响应示例**：
98
+
99
+ ```json
100
+ {
101
+ "key": "value"
102
+ }
103
+ ```
104
+
105
+ ## 性能特征
106
+
107
+ | 瓶颈 | 影响 | 优化方向 |
108
+ |------|------|----------|
109
+ | 描述 | 影响范围 | 优化方案 |
110
+
111
+ ## 运维指南
112
+
113
+ ### 部署
114
+
115
+ 部署步骤和注意事项。
116
+
117
+ ### 监控
118
+
119
+ 关键指标和告警规则。
120
+
121
+ ### 故障排除
122
+
123
+ 按"症状 → 原因 → 修复"格式记录。
124
+
125
+ ## 术语表
126
+
127
+ | 术语 | 定义 |
128
+ |------|------|
129
+ | 术语 A | 技术定义 |
130
+ | 术语 B | 技术定义 |
131
+
132
+ ## 相关资源
133
+
134
+ - spec: `docs/features/<feature-id>/<文件前缀>-spec.md`
135
+ - plan: `docs/features/<feature-id>/plan/<文件前缀>-index.md`
136
+ - 相关代码: 相对路径
137
+ - 外部文档: URL
138
+ ```
139
+
140
+ ## 设计文档 Markdown 章节内容指南
141
+
142
+ | 章节 | 主来源 | 辅来源 | 改写方向 |
143
+ |------|------------------------|----------|----------|
144
+ | 概述 | spec 目标与范围 | knowledge Summary | 保留技术精确度,补充架构上下文 |
145
+ | 架构设计 | spec 系统行为/接口边界 | knowledge Summary + Read 原文 | 补充系统级架构图(ASCII 文本框图)、数据流描述 |
146
+ | 核心模块 | plan 任务拆分 | knowledge Summary | 按模块分组,说明职责和交互关系 |
147
+ | 数据模型 | plan schema 任务 | spec 数据口径 + Read 原文 | 用表格展示节点类型、属性、关系 |
148
+ | 技术决策 | spec 不可留实现期决策 | knowledge Decisions + Read 原文 | 保留决策理由,补充替代方案对比,按"选择/原因/替代方案"格式 |
149
+ | API 参考 | spec 接口边界 | plan backend 任务 + Read 原文 | 按 endpoint 分组,包含请求参数表格和响应示例 |
150
+ | 性能特征 | knowledge Findings | Read 原文 | 用表格展示瓶颈和优化方向 |
151
+ | 已知限制 | spec 待确认项 | knowledge Findings/Risks + Read 原文 | 按严重程度排序,用表格说明影响范围和应对措施 |
152
+ | 扩展方向 | knowledge Outlook | Read 原文 | 按优先级排序,用编号列表说明实现复杂度 |
153
+ | 运维指南 | knowledge Operations | Read 原文 | 按"部署 / 监控 / 故障排除"分子章节 |
154
+
155
+ ## 格式规则
156
+
157
+ - 架构图使用代码块中的 ASCII 文本框图,不标注语言类型
158
+ - 技术决策按"选择 / 原因 / 替代方案"列表格式
159
+ - 代码示例标注语言类型(`rust`、`bash`、`json` 等)
160
+ - 文件路径使用行内代码包裹:`src/main.rs`
161
+ - HTTP 方法使用行内代码包裹:`POST /api/search/hybrid`
162
+ - 模块描述使用 `###` 子标题
163
+ - 表格优先用于结构化信息(限制、API 参数、性能瓶颈)
164
+ - 不要在文档中引用 AI 知识文档的路径或文件名;如需引用代码用相对路径