@snowcore8/dsh-global-user-constraints 0.0.0-stage → 0.8.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 (44) hide show
  1. package/LICENSE +12 -0
  2. package/LICENSE-CC-BY-4.0.txt +396 -0
  3. package/LICENSE-MIT.txt +21 -0
  4. package/README.md +151 -2
  5. package/package.json +33 -4
  6. package/plugins/dsh/README.md +65 -0
  7. package/plugins/dsh/cordis.patch.yml +4 -0
  8. package/plugins/dsh/src/index.js +133 -0
  9. package/rules/global-user-constraints.md +398 -0
  10. package/skills/api-and-data-conventions/SKILL.md +198 -0
  11. package/skills/api-and-data-conventions/references/checklists.md +179 -0
  12. package/skills/api-and-data-conventions/references/dimensions.md +188 -0
  13. package/skills/code-style-conventions/SKILL.md +204 -0
  14. package/skills/code-style-conventions/references/dimensions.md +289 -0
  15. package/skills/code-style-conventions/references/languages.md +224 -0
  16. package/skills/comment-conventions/SKILL.md +235 -0
  17. package/skills/comment-conventions/references/dimensions.md +339 -0
  18. package/skills/comment-conventions/references/languages.md +207 -0
  19. package/skills/documentation-conventions/SKILL.md +233 -0
  20. package/skills/documentation-conventions/references/dimensions.md +381 -0
  21. package/skills/documentation-conventions/references/templates.md +382 -0
  22. package/skills/naming-conventions/SKILL.md +251 -0
  23. package/skills/naming-conventions/references/dimensions.md +442 -0
  24. package/skills/naming-conventions/references/languages.md +175 -0
  25. package/skills/release-operations-conventions/SKILL.md +194 -0
  26. package/skills/release-operations-conventions/references/dimensions.md +265 -0
  27. package/skills/release-operations-conventions/references/playbooks.md +228 -0
  28. package/skills/repository-governance-conventions/SKILL.md +206 -0
  29. package/skills/repository-governance-conventions/references/dimensions.md +206 -0
  30. package/skills/repository-governance-conventions/references/playbooks.md +201 -0
  31. package/skills/security-compliance-conventions/SKILL.md +204 -0
  32. package/skills/security-compliance-conventions/references/checklists.md +197 -0
  33. package/skills/security-compliance-conventions/references/dimensions.md +246 -0
  34. package/skills/system-prompt-authoring/SKILL.md +435 -0
  35. package/skills/system-prompt-authoring/references/complex-logic.md +92 -0
  36. package/skills/system-prompt-authoring/references/provenance.md +130 -0
  37. package/skills/system-prompt-authoring/scripts/check.py +1635 -0
  38. package/skills/system-prompt-authoring/scripts/test_check.py +903 -0
  39. package/skills/testing-and-quality-conventions/SKILL.md +203 -0
  40. package/skills/testing-and-quality-conventions/references/dimensions.md +227 -0
  41. package/skills/testing-and-quality-conventions/references/gates.md +205 -0
  42. package/skills/vcs-collaboration-conventions/SKILL.md +205 -0
  43. package/skills/vcs-collaboration-conventions/references/dimensions.md +248 -0
  44. package/skills/vcs-collaboration-conventions/references/playbooks.md +206 -0
package/LICENSE ADDED
@@ -0,0 +1,12 @@
1
+ 本仓库采用双许可证,按文件类型划分:
2
+
3
+ - 文档与规范正文:CC BY 4.0,全文见 LICENSE-CC-BY-4.0.txt。
4
+ 适用 rules/、plugins/global-user-constraints/skills/、docs/、README.md、
5
+ CONTRIBUTING.md、GLOSSARY.md、CHANGELOG.md 等 Markdown 与说明内容。
6
+ - 代码、脚本与配置:MIT,全文见 LICENSE-MIT.txt。
7
+ 适用 scripts/、plugins/global-user-constraints/scripts/、
8
+ plugins/global-user-constraints/hooks/、.github/ 等可执行代码与配置。
9
+
10
+ 软链入口(AGENTS.md、.qwen/、.qoder/、.dsh/)随目标文件适用相应许可证。
11
+
12
+ Copyright (c) 2026 SnowCore8
@@ -0,0 +1,396 @@
1
+ Attribution 4.0 International
2
+
3
+ =======================================================================
4
+
5
+ Creative Commons Corporation ("Creative Commons") is not a law firm and
6
+ does not provide legal services or legal advice. Distribution of
7
+ Creative Commons public licenses does not create a lawyer-client or
8
+ other relationship. Creative Commons makes its licenses and related
9
+ information available on an "as-is" basis. Creative Commons gives no
10
+ warranties regarding its licenses, any material licensed under their
11
+ terms and conditions, or any related information. Creative Commons
12
+ disclaims all liability for damages resulting from their use to the
13
+ fullest extent possible.
14
+
15
+ Using Creative Commons Public Licenses
16
+
17
+ Creative Commons public licenses provide a standard set of terms and
18
+ conditions that creators and other rights holders may use to share
19
+ original works of authorship and other material subject to copyright
20
+ and certain other rights specified in the public license below. The
21
+ following considerations are for informational purposes only, are not
22
+ exhaustive, and do not form part of our licenses.
23
+
24
+ Considerations for licensors: Our public licenses are
25
+ intended for use by those authorized to give the public
26
+ permission to use material in ways otherwise restricted by
27
+ copyright and certain other rights. Our licenses are
28
+ irrevocable. Licensors should read and understand the terms
29
+ and conditions of the license they choose before applying it.
30
+ Licensors should also secure all rights necessary before
31
+ applying our licenses so that the public can reuse the
32
+ material as expected. Licensors should clearly mark any
33
+ material not subject to the license. This includes other CC-
34
+ licensed material, or material used under an exception or
35
+ limitation to copyright. More considerations for licensors:
36
+ wiki.creativecommons.org/Considerations_for_licensors
37
+
38
+ Considerations for the public: By using one of our public
39
+ licenses, a licensor grants the public permission to use the
40
+ licensed material under specified terms and conditions. If
41
+ the licensor's permission is not necessary for any reason--for
42
+ example, because of any applicable exception or limitation to
43
+ copyright--then that use is not regulated by the license. Our
44
+ licenses grant only permissions under copyright and certain
45
+ other rights that a licensor has authority to grant. Use of
46
+ the licensed material may still be restricted for other
47
+ reasons, including because others have copyright or other
48
+ rights in the material. A licensor may make special requests,
49
+ such as asking that all changes be marked or described.
50
+ Although not required by our licenses, you are encouraged to
51
+ respect those requests where reasonable. More considerations
52
+ for the public:
53
+ wiki.creativecommons.org/Considerations_for_licensees
54
+
55
+ =======================================================================
56
+
57
+ Creative Commons Attribution 4.0 International Public License
58
+
59
+ By exercising the Licensed Rights (defined below), You accept and agree
60
+ to be bound by the terms and conditions of this Creative Commons
61
+ Attribution 4.0 International Public License ("Public License"). To the
62
+ extent this Public License may be interpreted as a contract, You are
63
+ granted the Licensed Rights in consideration of Your acceptance of
64
+ these terms and conditions, and the Licensor grants You such rights in
65
+ consideration of benefits the Licensor receives from making the
66
+ Licensed Material available under these terms and conditions.
67
+
68
+
69
+ Section 1 -- Definitions.
70
+
71
+ a. Adapted Material means material subject to Copyright and Similar
72
+ Rights that is derived from or based upon the Licensed Material
73
+ and in which the Licensed Material is translated, altered,
74
+ arranged, transformed, or otherwise modified in a manner requiring
75
+ permission under the Copyright and Similar Rights held by the
76
+ Licensor. For purposes of this Public License, where the Licensed
77
+ Material is a musical work, performance, or sound recording,
78
+ Adapted Material is always produced where the Licensed Material is
79
+ synched in timed relation with a moving image.
80
+
81
+ b. Adapter's License means the license You apply to Your Copyright
82
+ and Similar Rights in Your contributions to Adapted Material in
83
+ accordance with the terms and conditions of this Public License.
84
+
85
+ c. Copyright and Similar Rights means copyright and/or similar rights
86
+ closely related to copyright including, without limitation,
87
+ performance, broadcast, sound recording, and Sui Generis Database
88
+ Rights, without regard to how the rights are labeled or
89
+ categorized. For purposes of this Public License, the rights
90
+ specified in Section 2(b)(1)-(2) are not Copyright and Similar
91
+ Rights.
92
+
93
+ d. Effective Technological Measures means those measures that, in the
94
+ absence of proper authority, may not be circumvented under laws
95
+ fulfilling obligations under Article 11 of the WIPO Copyright
96
+ Treaty adopted on December 20, 1996, and/or similar international
97
+ agreements.
98
+
99
+ e. Exceptions and Limitations means fair use, fair dealing, and/or
100
+ any other exception or limitation to Copyright and Similar Rights
101
+ that applies to Your use of the Licensed Material.
102
+
103
+ f. Licensed Material means the artistic or literary work, database,
104
+ or other material to which the Licensor applied this Public
105
+ License.
106
+
107
+ g. Licensed Rights means the rights granted to You subject to the
108
+ terms and conditions of this Public License, which are limited to
109
+ all Copyright and Similar Rights that apply to Your use of the
110
+ Licensed Material and that the Licensor has authority to license.
111
+
112
+ h. Licensor means the individual(s) or entity(ies) granting rights
113
+ under this Public License.
114
+
115
+ i. Share means to provide material to the public by any means or
116
+ process that requires permission under the Licensed Rights, such
117
+ as reproduction, public display, public performance, distribution,
118
+ dissemination, communication, or importation, and to make material
119
+ available to the public including in ways that members of the
120
+ public may access the material from a place and at a time
121
+ individually chosen by them.
122
+
123
+ j. Sui Generis Database Rights means rights other than copyright
124
+ resulting from Directive 96/9/EC of the European Parliament and of
125
+ the Council of 11 March 1996 on the legal protection of databases,
126
+ as amended and/or succeeded, as well as other essentially
127
+ equivalent rights anywhere in the world.
128
+
129
+ k. You means the individual or entity exercising the Licensed Rights
130
+ under this Public License. Your has a corresponding meaning.
131
+
132
+
133
+ Section 2 -- Scope.
134
+
135
+ a. License grant.
136
+
137
+ 1. Subject to the terms and conditions of this Public License,
138
+ the Licensor hereby grants You a worldwide, royalty-free,
139
+ non-sublicensable, non-exclusive, irrevocable license to
140
+ exercise the Licensed Rights in the Licensed Material to:
141
+
142
+ a. reproduce and Share the Licensed Material, in whole or
143
+ in part; and
144
+
145
+ b. produce, reproduce, and Share Adapted Material.
146
+
147
+ 2. Exceptions and Limitations. For the avoidance of doubt, where
148
+ Exceptions and Limitations apply to Your use, this Public
149
+ License does not apply, and You do not need to comply with
150
+ its terms and conditions.
151
+
152
+ 3. Term. The term of this Public License is specified in Section
153
+ 6(a).
154
+
155
+ 4. Media and formats; technical modifications allowed. The
156
+ Licensor authorizes You to exercise the Licensed Rights in
157
+ all media and formats whether now known or hereafter created,
158
+ and to make technical modifications necessary to do so. The
159
+ Licensor waives and/or agrees not to assert any right or
160
+ authority to forbid You from making technical modifications
161
+ necessary to exercise the Licensed Rights, including
162
+ technical modifications necessary to circumvent Effective
163
+ Technological Measures. For purposes of this Public License,
164
+ simply making modifications authorized by this Section 2(a)
165
+ (4) never produces Adapted Material.
166
+
167
+ 5. Downstream recipients.
168
+
169
+ a. Offer from the Licensor -- Licensed Material. Every
170
+ recipient of the Licensed Material automatically
171
+ receives an offer from the Licensor to exercise the
172
+ Licensed Rights under the terms and conditions of this
173
+ Public License.
174
+
175
+ b. No downstream restrictions. You may not offer or impose
176
+ any additional or different terms or conditions on, or
177
+ apply any Effective Technological Measures to, the
178
+ Licensed Material if doing so restricts exercise of the
179
+ Licensed Rights by any recipient of the Licensed
180
+ Material.
181
+
182
+ 6. No endorsement. Nothing in this Public License constitutes or
183
+ may be construed as permission to assert or imply that You
184
+ are, or that Your use of the Licensed Material is, connected
185
+ with, or sponsored, endorsed, or granted official status by,
186
+ the Licensor or others designated to receive attribution as
187
+ provided in Section 3(a)(1)(A)(i).
188
+
189
+ b. Other rights.
190
+
191
+ 1. Moral rights, such as the right of integrity, are not
192
+ licensed under this Public License, nor are publicity,
193
+ privacy, and/or other similar personality rights; however, to
194
+ the extent possible, the Licensor waives and/or agrees not to
195
+ assert any such rights held by the Licensor to the limited
196
+ extent necessary to allow You to exercise the Licensed
197
+ Rights, but not otherwise.
198
+
199
+ 2. Patent and trademark rights are not licensed under this
200
+ Public License.
201
+
202
+ 3. To the extent possible, the Licensor waives any right to
203
+ collect royalties from You for the exercise of the Licensed
204
+ Rights, whether directly or through a collecting society
205
+ under any voluntary or waivable statutory or compulsory
206
+ licensing scheme. In all other cases the Licensor expressly
207
+ reserves any right to collect such royalties.
208
+
209
+
210
+ Section 3 -- License Conditions.
211
+
212
+ Your exercise of the Licensed Rights is expressly made subject to the
213
+ following conditions.
214
+
215
+ a. Attribution.
216
+
217
+ 1. If You Share the Licensed Material (including in modified
218
+ form), You must:
219
+
220
+ a. retain the following if it is supplied by the Licensor
221
+ with the Licensed Material:
222
+
223
+ i. identification of the creator(s) of the Licensed
224
+ Material and any others designated to receive
225
+ attribution, in any reasonable manner requested by
226
+ the Licensor (including by pseudonym if
227
+ designated);
228
+
229
+ ii. a copyright notice;
230
+
231
+ iii. a notice that refers to this Public License;
232
+
233
+ iv. a notice that refers to the disclaimer of
234
+ warranties;
235
+
236
+ v. a URI or hyperlink to the Licensed Material to the
237
+ extent reasonably practicable;
238
+
239
+ b. indicate if You modified the Licensed Material and
240
+ retain an indication of any previous modifications; and
241
+
242
+ c. indicate the Licensed Material is licensed under this
243
+ Public License, and include the text of, or the URI or
244
+ hyperlink to, this Public License.
245
+
246
+ 2. You may satisfy the conditions in Section 3(a)(1) in any
247
+ reasonable manner based on the medium, means, and context in
248
+ which You Share the Licensed Material. For example, it may be
249
+ reasonable to satisfy the conditions by providing a URI or
250
+ hyperlink to a resource that includes the required
251
+ information.
252
+
253
+ 3. If requested by the Licensor, You must remove any of the
254
+ information required by Section 3(a)(1)(A) to the extent
255
+ reasonably practicable.
256
+
257
+ 4. If You Share Adapted Material You produce, the Adapter's
258
+ License You apply must not prevent recipients of the Adapted
259
+ Material from complying with this Public License.
260
+
261
+
262
+ Section 4 -- Sui Generis Database Rights.
263
+
264
+ Where the Licensed Rights include Sui Generis Database Rights that
265
+ apply to Your use of the Licensed Material:
266
+
267
+ a. for the avoidance of doubt, Section 2(a)(1) grants You the right
268
+ to extract, reuse, reproduce, and Share all or a substantial
269
+ portion of the contents of the database;
270
+
271
+ b. if You include all or a substantial portion of the database
272
+ contents in a database in which You have Sui Generis Database
273
+ Rights, then the database in which You have Sui Generis Database
274
+ Rights (but not its individual contents) is Adapted Material; and
275
+
276
+ c. You must comply with the conditions in Section 3(a) if You Share
277
+ all or a substantial portion of the contents of the database.
278
+
279
+ For the avoidance of doubt, this Section 4 supplements and does not
280
+ replace Your obligations under this Public License where the Licensed
281
+ Rights include other Copyright and Similar Rights.
282
+
283
+
284
+ Section 5 -- Disclaimer of Warranties and Limitation of Liability.
285
+
286
+ a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
287
+ EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
288
+ AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
289
+ ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
290
+ IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
291
+ WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
292
+ PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
293
+ ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
294
+ KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
295
+ ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
296
+
297
+ b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
298
+ TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
299
+ NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
300
+ INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
301
+ COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
302
+ USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
303
+ ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
304
+ DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
305
+ IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
306
+
307
+ c. The disclaimer of warranties and limitation of liability provided
308
+ above shall be interpreted in a manner that, to the extent
309
+ possible, most closely approximates an absolute disclaimer and
310
+ waiver of all liability.
311
+
312
+
313
+ Section 6 -- Term and Termination.
314
+
315
+ a. This Public License applies for the term of the Copyright and
316
+ Similar Rights licensed here. However, if You fail to comply with
317
+ this Public License, then Your rights under this Public License
318
+ terminate automatically.
319
+
320
+ b. Where Your right to use the Licensed Material has terminated under
321
+ Section 6(a), it reinstates:
322
+
323
+ 1. automatically as of the date the violation is cured, provided
324
+ it is cured within 30 days of Your discovery of the
325
+ violation; or
326
+
327
+ 2. upon express reinstatement by the Licensor.
328
+
329
+ For the avoidance of doubt, this Section 6(b) does not affect any
330
+ right the Licensor may have to seek remedies for Your violations
331
+ of this Public License.
332
+
333
+ c. For the avoidance of doubt, the Licensor may also offer the
334
+ Licensed Material under separate terms or conditions or stop
335
+ distributing the Licensed Material at any time; however, doing so
336
+ will not terminate this Public License.
337
+
338
+ d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
339
+ License.
340
+
341
+
342
+ Section 7 -- Other Terms and Conditions.
343
+
344
+ a. The Licensor shall not be bound by any additional or different
345
+ terms or conditions communicated by You unless expressly agreed.
346
+
347
+ b. Any arrangements, understandings, or agreements regarding the
348
+ Licensed Material not stated herein are separate from and
349
+ independent of the terms and conditions of this Public License.
350
+
351
+
352
+ Section 8 -- Interpretation.
353
+
354
+ a. For the avoidance of doubt, this Public License does not, and
355
+ shall not be interpreted to, reduce, limit, restrict, or impose
356
+ conditions on any use of the Licensed Material that could lawfully
357
+ be made without permission under this Public License.
358
+
359
+ b. To the extent possible, if any provision of this Public License is
360
+ deemed unenforceable, it shall be automatically reformed to the
361
+ minimum extent necessary to make it enforceable. If the provision
362
+ cannot be reformed, it shall be severed from this Public License
363
+ without affecting the enforceability of the remaining terms and
364
+ conditions.
365
+
366
+ c. No term or condition of this Public License will be waived and no
367
+ failure to comply consented to unless expressly agreed to by the
368
+ Licensor.
369
+
370
+ d. Nothing in this Public License constitutes or may be interpreted
371
+ as a limitation upon, or waiver of, any privileges and immunities
372
+ that apply to the Licensor or You, including from the legal
373
+ processes of any jurisdiction or authority.
374
+
375
+
376
+ =======================================================================
377
+
378
+ Creative Commons is not a party to its public
379
+ licenses. Notwithstanding, Creative Commons may elect to apply one of
380
+ its public licenses to material it publishes and in those instances
381
+ will be considered the “Licensor.” The text of the Creative Commons
382
+ public licenses is dedicated to the public domain under the CC0 Public
383
+ Domain Dedication. Except for the limited purpose of indicating that
384
+ material is shared under a Creative Commons public license or as
385
+ otherwise permitted by the Creative Commons policies published at
386
+ creativecommons.org/policies, Creative Commons does not authorize the
387
+ use of the trademark "Creative Commons" or any other trademark or logo
388
+ of Creative Commons without its prior written consent including,
389
+ without limitation, in connection with any unauthorized modifications
390
+ to any of its public licenses or any other arrangements,
391
+ understandings, or agreements concerning use of licensed material. For
392
+ the avoidance of doubt, this paragraph does not form part of the
393
+ public licenses.
394
+
395
+ Creative Commons may be contacted at creativecommons.org.
396
+
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 SnowCore8
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,152 @@
1
- # Temporary Holding Version
1
+ # AI 编码代理 system prompt
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 本仓库维护用户全局约束、十一个通用规范 skill,以及分别面向 Qoder、Qwen Code 与
4
+ DeepSeek Harness(DSH)的三个插件包。`rules/`、`skills/` 与 `shared/` 是唯一真源,
5
+ 三个包用相对软链引用它们,打包时物化成自包含目录。
6
+
7
+ 维护者:SnowCore8,职责与决策规则见 [GOVERNANCE.md](GOVERNANCE.md)。
8
+ 项目维护约定见 [CONTRIBUTING.md](CONTRIBUTING.md)(根 `AGENTS.md` 是它的软链入口)。
9
+
10
+ ## 目录
11
+
12
+ | 路径 | 作用 |
13
+ |---|---|
14
+ | `rules/global-user-constraints.md` | 用户全局约束正文(唯一权威来源) |
15
+ | `skills/` | 十一个 skill 的真源 |
16
+ | `shared/commands/` | 手动审查命令 |
17
+ | `shared/scripts/` | 约束注入、时间注入脚本及其测试 |
18
+ | `plugins/qoder/` | Qoder 插件包(`.qoder-plugin/plugin.json`) |
19
+ | `plugins/qwen/` | Qwen Code 扩展包(`qwen-extension.json`) |
20
+ | `package.json`(仓库根) | DSH bundle 清单与 git 源安装入口 |
21
+ | `plugins/dsh/` | DSH bundle 的插件源码、patch 与说明 |
22
+ | `plugins/marketplace.json` | Qoder 本地市场描述,指向 `plugins/qoder` |
23
+ | `.qwen/rules`、`.qwen/skills/` | Qwen Code 项目级入口,软链到顶层真源 |
24
+ | `.qoder/rules`、`.qoder/skills/` | Qoder 项目级入口,软链到顶层真源 |
25
+ | `.dsh/skills/` | DSH 项目级 skill 入口,软链到顶层真源 |
26
+ | `AGENTS.md` | 项目维护约定入口,软链指向 `CONTRIBUTING.md` |
27
+ | `docs/agent-tooling-loading.md` | 三工具 rules/skills/plugins 加载规则调研 |
28
+ | `docs/time-awareness.md` | Qoder/Qwen 时间注入设计 |
29
+ | `docs/release.md` | 版本规则、tag 发布流程与回滚 |
30
+ | `scripts/` | `check.sh` 全量校验、`dist.sh` 出包、`materialize.sh` 物化 |
31
+ | `GLOSSARY.md` | 术语与写法约定 |
32
+ | `CHANGELOG.md` | 按版本记录的可观察变更 |
33
+ | `GOVERNANCE.md` | 维护者、决策、审查与发布规则 |
34
+ | `THIRD-PARTY-NOTICES.md` | 开发依赖与第三方许可声明 |
35
+ | `LICENSE`、`LICENSE-CC-BY-4.0.txt`、`LICENSE-MIT.txt` | 双许可证:文档 CC BY 4.0,代码 MIT |
36
+ | `SECURITY.md` | 支持的版本与私下漏洞报告渠道 |
37
+ | `.github/` | CI 与 Release 工作流、Dependabot、CODEOWNERS 与 PR 模板 |
38
+
39
+ ## 编辑
40
+
41
+ 1. 改约束:编辑 `rules/global-user-constraints.md`(唯一权威来源)。
42
+ 2. 改 skill:编辑 `skills/` 下对应的 skill;三个包自动引用,不复制第二份。
43
+ 3. 改命令或注入脚本:编辑 `shared/commands/` 或 `shared/scripts/`。
44
+ 4. 改某一端的清单或 hook:编辑 `plugins/<包>/` 下对应文件,并同步三包版本。
45
+ 5. 新增入口时按「软链约定」执行,改完运行 `scripts/check.sh`。
46
+
47
+ ## 软链约定
48
+
49
+ - 软链只做入口,不承载内容:目标必须在仓库内、用相对路径、指向真实文件或目录,且不指向另一软链。
50
+ - 每个入口只指向唯一真源(`rules/`、`skills/` 或 `shared/`),不复制第二份文件。
51
+ - 三个包内部的 `skills/`、`rules/`、`commands/`、`scripts/` 都是指向顶层真源的软链;
52
+ Qoder 的 `plugins validate` 会拒绝解析到包外的路径,所以安装或校验前用
53
+ `scripts/materialize.sh` 物化,或直接用 Release 里的 zip。
54
+ - `scripts/check.sh` 的「软链」「插件清单」段校验未入库、缺失、绝对路径、目标出仓、指向 `.git`、
55
+ 链式软链、目标不存在或未跟踪,以及三个包的软链是否指向正确真源。
56
+ - Windows 检出需启用 `core.symlinks`;否则软链会落成普通文本文件。
57
+
58
+ ## 三个包
59
+
60
+ | 包 | 清单 | hook 形式 | 安装 |
61
+ |---|---|---|---|
62
+ | `plugins/qoder` | `.qoder-plugin/plugin.json` | `command` + `args`,`${QODER_PLUGIN_ROOT}` | `qoderclicn plugins install <zip> --scope user` |
63
+ | `plugins/qwen` | `qwen-extension.json` | 单条 `command` 字符串,`${CLAUDE_PLUGIN_ROOT}` | `qwen extensions install <zip>` |
64
+ | `plugins/dsh` | 仓库根 `package.json` 的 `dsh.bundle.patch` | 无 hook;注册 skill 提供者 | `dsh plugin --profile <名> add "github:SnowCore8/system_prompt#<tag>"` |
65
+
66
+ 三包共用版本号,发布时一起出包;清单版本不一致会被 `scripts/check.sh`、`scripts/dist.sh`
67
+ 与 release 工作流拒绝。
68
+
69
+ ## DeepSeek Harness 适配
70
+
71
+ - 项目级:`.dsh/skills/` 是 rank 100 的 skill 扫描根,软链到顶层 `skills/`;根 `AGENTS.md`
72
+ 由 `dsh-agent-instructions` 作为指令链加载。
73
+ - bundle:仓库根 `package.json` 声明 `dsh.bundle.patch`,`plugins/dsh/src/index.js` 注册
74
+ `ctx.skills.registerProvider`,把十一个 skill 提供给任意 profile。
75
+ - 安装:发布流水线把根包发到 npm 公共 registry,直接
76
+ `pnpm dsh plugin --profile web add @snowcore8/dsh-global-user-constraints@<版本>`,
77
+ 插件页能检测到更新。也可以从 GitHub 源安装(tag 方式不会检测更新):
78
+ `pnpm dsh plugin --profile web add "github:SnowCore8/system_prompt#v0.8.0"`。
79
+ 细节见 [plugins/dsh/README.md](plugins/dsh/README.md)。
80
+ - 约束:DSH 的用户级指令链读取 `~/.dsh/AGENTS.md`,把 `rules/global-user-constraints.md`
81
+ 复制到该位置即可;时间由 DSH 自身注入,不需要额外 hook。
82
+
83
+ ## Qwen Code 适配
84
+
85
+ - 项目级:`.qwen/rules/` 软链到 `rules/`(无 `paths:`,baseline,首请求生效);`.qwen/skills/`
86
+ 软链到十一个 skill;`.qwen/AGENTS.md` 不被 Qwen 读取,仓库不提供。
87
+ - 扩展:`plugins/qwen` 的 `qwen-extension.json` 指向 `hooks/qwen-hooks.json`,安装后
88
+ `SessionStart` 注入约束全文与时间,`UserPromptSubmit` 刷新时间;已有同内容规则或
89
+ `AGENTS.md` 时跳过。
90
+ - 时间:Qwen 没有内建时间感知,注入格式与设计见 [docs/time-awareness.md](docs/time-awareness.md)。
91
+
92
+ ## Qoder 适配
93
+
94
+ - 项目级:`.qoder/rules` 软链到 `rules/`,Qoder 从当前目录向上查到 `.git` 逐层读取;
95
+ `.qoder/skills/` 软链到十一个 skill。
96
+ - 插件:`plugins/qoder` 安装后 `SessionStart` 注入约束全文与时间,`UserPromptSubmit` 刷新时间;
97
+ 去重路径覆盖 `~/.qoder-cn/rules/`(国际版 `~/.qoder/rules/`)、`AGENTS.md`、`.qoder/rules/`。
98
+ - 项目级不提供 `.qoder-cn` 与 `.qoder/plugins`:它们在项目级没有加载语义。
99
+
100
+ ## 验证
101
+
102
+ ```bash
103
+ python3 -m pip install -r requirements-dev.txt # 建议用虚拟环境
104
+ scripts/check.sh
105
+ ```
106
+
107
+ `scripts/check.sh` 覆盖 Markdown、skill 与 hook 测试、DSH bundle 的 `node --test`、shellcheck、
108
+ ruff、JSON、敏感文件、软链、三工具项目级适配、三包清单一致性与物化后的 Qoder 插件校验。
109
+ 缺 `shellcheck`、`node` 或 `qoderclicn` 时会打印「跳过」并在结尾计数。
110
+
111
+ 本地安装 smoke test:
112
+
113
+ ```bash
114
+ scripts/materialize.sh qoder /tmp/qoder-package
115
+ qoderclicn --cwd /tmp plugins install --scope local /tmp/qoder-package
116
+ qoderclicn --cwd /tmp plugins list --json
117
+ ```
118
+
119
+ ## 打包
120
+
121
+ 版本采用 SemVer,三个清单的 `version` 必须一致;发布流程是「改三包版本与 CHANGELOG → 提交 →
122
+ 打 `v<version>` 注释 tag → 推送」,由 release 工作流分别构建三个 zip,详见 [docs/release.md](docs/release.md)。
123
+
124
+ 本地出包运行 `scripts/dist.sh`:默认要求工作区干净(`--allow-dirty` 放行),浅克隆直接拒绝,
125
+ `--require-tag` 要求 HEAD 正好带有 `v<version>` tag。每个包物化后归一 mtime 与权限、按名称排序、
126
+ 用 `zip -X` 构建,输出可复现 zip 与 SHA256,各保留最近三个制品。zip 与 `*.sha256` 被 `.gitignore`
127
+ 忽略,不提交。
128
+
129
+ ## CI
130
+
131
+ - `check`:push 到 `master` 与 pull request 时运行 `scripts/check.sh`,最小 `contents: read` 权限,
132
+ 并先确认 runner 自带 `shellcheck`。
133
+ - `release`:推送 `v*` tag 时核对三包版本与 tag,构建三个 zip 与 SHA256 并挂到 Release;
134
+ 该工作流没有 `qoderclicn`,用 `--no-validate` 换取可重复构建,插件校验在本地发布前完成。
135
+ - 依赖更新由 Dependabot 每周检查 pip 与 GitHub Actions。
136
+ - 分支保护在私有仓库免费计划下不可用(需 GitHub Pro),升级后按 GOVERNANCE 的保护项启用。
137
+
138
+ ## 安全
139
+
140
+ 漏洞报告首选 GitHub 私下漏洞报告,入口不可用时邮件联系维护者,不接受公开 issue 披露;支持版本、
141
+ 处理流程、范围与渠道可用性见 [SECURITY.md](SECURITY.md)。仓库不保存任何密钥或个人数据。
142
+
143
+ ## 许可证
144
+
145
+ 双许可证:文档与规范正文(`rules/`、skill 正文、`docs/`、说明类 Markdown)采用
146
+ [CC BY 4.0](LICENSE-CC-BY-4.0.txt),代码、脚本与配置(`scripts/`、`shared/`、`plugins/*/hooks/`、
147
+ `.github/`)采用 [MIT](LICENSE-MIT.txt)。范围划分见 [LICENSE](LICENSE)。
148
+
149
+ ## 变更日志
150
+
151
+ 可观察变更按版本记录在 [CHANGELOG.md](CHANGELOG.md);版本采用 SemVer,发布点为 tag `v<version>`,
152
+ 对应的 zip 与 SHA256 挂在 GitHub Release。
package/package.json CHANGED
@@ -1,6 +1,35 @@
1
1
  {
2
2
  "name": "@snowcore8/dsh-global-user-constraints",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.8.0",
4
+ "description": "DSH bundle(Git 源安装入口):以 skill 提供者形式暴露用户全局约束的十一个通用规范 skill。",
5
+ "type": "module",
6
+ "main": "plugins/dsh/src/index.js",
7
+ "files": [
8
+ "plugins/dsh/src",
9
+ "plugins/dsh/cordis.patch.yml",
10
+ "plugins/dsh/README.md",
11
+ "skills",
12
+ "rules",
13
+ "README.md",
14
+ "LICENSE",
15
+ "LICENSE-CC-BY-4.0.txt",
16
+ "LICENSE-MIT.txt"
17
+ ],
18
+ "engines": {
19
+ "dsh": ">=0.2.2-rc.1 <0.3.0"
20
+ },
21
+ "dsh": {
22
+ "bundle": {
23
+ "patch": "./plugins/dsh/cordis.patch.yml"
24
+ }
25
+ },
26
+ "license": "MIT AND CC-BY-4.0",
27
+ "repository": {
28
+ "type": "git",
29
+ "url": "git+https://github.com/SnowCore8/system_prompt.git"
30
+ },
31
+ "publishConfig": {
32
+ "access": "public",
33
+ "registry": "https://registry.npmjs.org"
34
+ }
35
+ }