dsh-git-push 0.0.0-stage → 2.8.6
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.
- package/.auditignore +30 -0
- package/.gitignore +39 -0
- package/LICENSE +21 -0
- package/README.md +1486 -2
- package/cli.mjs +360 -0
- package/cordis.patch.yml +14 -0
- package/lib/ARCHITECTURE.md +34 -0
- package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
- package/lib/app/apply.js +275 -0
- package/lib/app/audit-api.js +158 -0
- package/lib/app/command-registry.js +266 -0
- package/lib/app/constants.js +16 -0
- package/lib/app/handlers/account.js +166 -0
- package/lib/app/handlers/clone.js +168 -0
- package/lib/app/handlers/http-constants.js +9 -0
- package/lib/app/handlers/identity-rewrite.js +94 -0
- package/lib/app/handlers/meta.js +175 -0
- package/lib/app/handlers/npm.js +169 -0
- package/lib/app/handlers/repo-actions.js +143 -0
- package/lib/app/handlers/repos.js +231 -0
- package/lib/app/handlers/settings.js +62 -0
- package/lib/app/host-doc-checks.js +25 -0
- package/lib/app/http-handlers.js +131 -0
- package/lib/app/index.js +30 -0
- package/lib/app/inject-text.js +192 -0
- package/lib/app/scan-root.js +23 -0
- package/lib/app/schema.js +150 -0
- package/lib/app/settings-bridge.js +167 -0
- package/lib/app/slash-commands.js +395 -0
- package/lib/app/slot-stats.js +35 -0
- package/lib/app/tool-call.js +672 -0
- package/lib/app/tools.js +34 -0
- package/lib/ast/brace.js +105 -0
- package/lib/ast/callgraph.js +135 -0
- package/lib/ast/code-lines.js +114 -0
- package/lib/ast/consts.js +12 -0
- package/lib/ast/control-flow.js +461 -0
- package/lib/ast/credential.js +199 -0
- package/lib/ast/dataflow.js +274 -0
- package/lib/ast/dup-code.js +165 -0
- package/lib/ast/index.js +36 -0
- package/lib/ast/io-risk-const.js +95 -0
- package/lib/ast/io-risk-fn.js +208 -0
- package/lib/ast/io-risk-loop.js +308 -0
- package/lib/ast/io-risk.js +314 -0
- package/lib/ast/lang.js +156 -0
- package/lib/ast/line-count.js +52 -0
- package/lib/ast/magic-number.js +272 -0
- package/lib/ast/naming.js +284 -0
- package/lib/ast/perf.js +472 -0
- package/lib/ast/scope.js +241 -0
- package/lib/ast/shell.js +131 -0
- package/lib/ast/size.js +378 -0
- package/lib/ast/symbol-index.js +399 -0
- package/lib/ast/tokenizer.js +341 -0
- package/lib/audit/analysis-coverage.js +98 -0
- package/lib/audit/audit-file.js +182 -0
- package/lib/audit/checks.js +17 -0
- package/lib/audit/client-entry.js +93 -0
- package/lib/audit/collector.js +477 -0
- package/lib/audit/ext-runner.js +80 -0
- package/lib/audit/file-context.js +138 -0
- package/lib/audit/finding.js +50 -0
- package/lib/audit/gitignore-match.js +113 -0
- package/lib/audit/glob.js +63 -0
- package/lib/audit/history-report.js +100 -0
- package/lib/audit/history.js +126 -0
- package/lib/audit/ignore-blind.js +101 -0
- package/lib/audit/index.js +33 -0
- package/lib/audit/orchestrate.js +476 -0
- package/lib/audit/public.js +24 -0
- package/lib/audit/repo-level.js +30 -0
- package/lib/audit/report-yaml.js +86 -0
- package/lib/audit/slot.js +65 -0
- package/lib/audit-defaults.js +18 -0
- package/lib/audit-rules/audit-rules-comment.yml +247 -0
- package/lib/audit-rules/audit-rules-cpp.yml +22 -0
- package/lib/audit-rules/audit-rules-docs.yml +32 -0
- package/lib/audit-rules/audit-rules-dsh.yml +162 -0
- package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
- package/lib/audit-rules/audit-rules-folder.yml +99 -0
- package/lib/audit-rules/audit-rules-frontend.yml +335 -0
- package/lib/audit-rules/audit-rules-go.yml +22 -0
- package/lib/audit-rules/audit-rules-i18n.yml +45 -0
- package/lib/audit-rules/audit-rules-java.yml +105 -0
- package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
- package/lib/audit-rules/audit-rules-npm.yml +187 -0
- package/lib/audit-rules/audit-rules-paths.yml +92 -0
- package/lib/audit-rules/audit-rules-performance.yml +215 -0
- package/lib/audit-rules/audit-rules-php.yml +22 -0
- package/lib/audit-rules/audit-rules-private.yml +24 -0
- package/lib/audit-rules/audit-rules-python.yml +106 -0
- package/lib/audit-rules/audit-rules-robustness.yml +27 -0
- package/lib/audit-rules/audit-rules-rust.yml +22 -0
- package/lib/audit-rules/audit-rules-structure.yml +159 -0
- package/lib/audit-rules/audit-rules-swift.yml +22 -0
- package/lib/audit-rules/audit-rules-template.yml +108 -0
- package/lib/checks/button-bind.js +276 -0
- package/lib/checks/common.js +170 -0
- package/lib/checks/credential-file.js +43 -0
- package/lib/checks/dataflow.js +40 -0
- package/lib/checks/dispatch.js +112 -0
- package/lib/checks/dup-code.js +69 -0
- package/lib/checks/dup-const.js +232 -0
- package/lib/checks/file-health.js +150 -0
- package/lib/checks/filter.js +137 -0
- package/lib/checks/folder.js +173 -0
- package/lib/checks/hardcoded-path.js +98 -0
- package/lib/checks/index.js +46 -0
- package/lib/checks/io.js +66 -0
- package/lib/checks/magic-number.js +42 -0
- package/lib/checks/npm-json.js +273 -0
- package/lib/checks/private.js +63 -0
- package/lib/checks/regex.js +256 -0
- package/lib/checks/semantic.js +134 -0
- package/lib/checks/structural.js +274 -0
- package/lib/cli/commands-account.mjs +107 -0
- package/lib/cli/commands-audit.mjs +144 -0
- package/lib/cli/commands-doc.mjs +127 -0
- package/lib/cli/commands-vcs.mjs +175 -0
- package/lib/client/index.js +162 -0
- package/lib/client-parts/00-loader.js +33 -0
- package/lib/client-parts/01-const.js +207 -0
- package/lib/client-parts/02-utils.js +62 -0
- package/lib/client-parts/03-icons.js +12 -0
- package/lib/client-parts/10-account.js +83 -0
- package/lib/client-parts/11-browser.js +95 -0
- package/lib/client-parts/20-repo.js +374 -0
- package/lib/client-parts/21-audit.js +301 -0
- package/lib/client-parts/22-settings.js +146 -0
- package/lib/client-parts/23-npm.js +383 -0
- package/lib/client-parts/30-page.js +56 -0
- package/lib/client-parts/40-controller.js +1092 -0
- package/lib/client-parts/41-actions.js +279 -0
- package/lib/client-parts/99-apply.js +72 -0
- package/lib/client.js +3195 -0
- package/lib/commit-push.js +148 -0
- package/lib/context/index.js +363 -0
- package/lib/core/atomic-json.js +98 -0
- package/lib/core/config.js +40 -0
- package/lib/core/credentials.js +274 -0
- package/lib/core/endpoints.js +109 -0
- package/lib/core/exec.js +162 -0
- package/lib/exempt/index.js +292 -0
- package/lib/fs/edit-after-read.js +103 -0
- package/lib/fsx.js +87 -0
- package/lib/git/account-status.js +140 -0
- package/lib/git/account.js +233 -0
- package/lib/git/api.js +136 -0
- package/lib/git/atomic-json.js +6 -0
- package/lib/git/browse.js +38 -0
- package/lib/git/clone-download.js +397 -0
- package/lib/git/clone-history-mode.js +143 -0
- package/lib/git/clone-history.js +175 -0
- package/lib/git/clone-jobs.js +250 -0
- package/lib/git/clone-replay-io.js +172 -0
- package/lib/git/clone-replay.js +275 -0
- package/lib/git/clone.js +445 -0
- package/lib/git/cloud.js +46 -0
- package/lib/git/commit-message.js +141 -0
- package/lib/git/config.js +6 -0
- package/lib/git/cred-env.js +88 -0
- package/lib/git/credentials.js +6 -0
- package/lib/git/endpoints.js +6 -0
- package/lib/git/exec.js +6 -0
- package/lib/git/identity-rewrite.js +297 -0
- package/lib/git/identity.js +150 -0
- package/lib/git/ignore.js +69 -0
- package/lib/git/index.js +41 -0
- package/lib/git/module-splitter.js +47 -0
- package/lib/git/post-push.js +101 -0
- package/lib/git/push-diagnose.js +142 -0
- package/lib/git/push.js +476 -0
- package/lib/git/remote-resolve.js +146 -0
- package/lib/git/remote.js +128 -0
- package/lib/git/repo-index.js +512 -0
- package/lib/git/repos.js +235 -0
- package/lib/git/scan-runner.js +159 -0
- package/lib/git/sensitive.js +134 -0
- package/lib/git/transport.js +430 -0
- package/lib/git/visibility.js +35 -0
- package/lib/git/wrapped-git.js +68 -0
- package/lib/http/index.js +170 -0
- package/lib/index.js +24 -0
- package/lib/link-check/index.js +187 -0
- package/lib/npm/account.js +64 -0
- package/lib/npm/install.js +211 -0
- package/lib/npm/npmrc.js +56 -0
- package/lib/npm/publish.js +171 -0
- package/lib/npm/registry.js +168 -0
- package/lib/plugin/auto-detect.js +92 -0
- package/lib/plugin/auto-push.js +154 -0
- package/lib/plugin/index.js +250 -0
- package/lib/readme-templates/readme.yml +38 -0
- package/lib/rule/compilers/credential.js +62 -0
- package/lib/rule/compilers/dataflow.js +38 -0
- package/lib/rule/compilers/file-health.js +75 -0
- package/lib/rule/compilers/frontend.js +86 -0
- package/lib/rule/compilers/func.js +35 -0
- package/lib/rule/compilers/helpers.js +71 -0
- package/lib/rule/compilers/index.js +29 -0
- package/lib/rule/compilers/link-semantic.js +45 -0
- package/lib/rule/compilers/list-kinds.js +12 -0
- package/lib/rule/compilers/numeric-kinds.js +66 -0
- package/lib/rule/compilers/regex.js +78 -0
- package/lib/rule/compilers/structure.js +80 -0
- package/lib/rule/compilers.js +17 -0
- package/lib/rule/homoglyph.js +45 -0
- package/lib/rule/loader.js +270 -0
- package/lib/rule/registry.js +115 -0
- package/lib/rule/scope.js +67 -0
- package/lib/score/docs-score.js +166 -0
- package/lib/score/index.js +140 -0
- package/lib/self/index.js +196 -0
- package/lib/skip-dirs.js +64 -0
- package/lib/tool-probes.json +50 -0
- package/lib/user-requirements.json +14 -0
- package/lib/vendor/js-yaml/LICENSE +21 -0
- package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
- package/package.json +95 -4
- package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
- package/scripts/audit-ext/_example-readme-present.mjs +34 -0
- package/scripts/audit-ext/variable-min-length.mjs +102 -0
- package/scripts/audit-runner.mjs +35 -0
- package/scripts/audit-runtime-check.mjs +129 -0
- package/scripts/browser-page-probe.mjs +271 -0
- package/scripts/build-client.mjs +119 -0
- package/scripts/check.mjs +88 -0
- package/scripts/clean-date-comments.py +102 -0
- package/scripts/cpu-sample.mjs +188 -0
- package/scripts/doc-drift.mjs +200 -0
- package/scripts/doc-func.mjs +212 -0
- package/scripts/doc-tree.mjs +456 -0
- package/scripts/doc-version.mjs +220 -0
- package/scripts/frontend-preview-check.mjs +124 -0
- package/scripts/hot-path-probe-cjs.cjs +71 -0
- package/scripts/hot-path-probe-fs-shim.mjs +28 -0
- package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
- package/scripts/hot-path-probe.mjs +153 -0
- package/scripts/module-splitter.py +800 -0
- package/scripts/platform-scan.mjs +168 -0
- package/scripts/preview-gen.mjs +489 -0
- package/scripts/preview-local-runner.mjs +55 -0
- package/scripts/preview-server-direct.mjs +116 -0
- package/scripts/preview-server.mjs +305 -0
- package/scripts/preview-slot-data.mjs +123 -0
- package/scripts/probe-recheck.mjs +47 -0
- package/scripts/readme-gen.mjs +268 -0
- package/scripts/rename-locator.mjs +97 -0
- package/scripts/rule-switch.mjs +97 -0
- package/scripts/rules-solo-audit.mjs +173 -0
- package/scripts/scan-file-io.mjs +713 -0
- package/scripts/scan-hardcoded-paths.mjs +125 -0
- package/scripts/scan-repos.mjs +167 -0
- package/scripts/scan-version.mjs +122 -0
- package/scripts/scrub-user-wording.mjs +420 -0
- package/scripts/symbol-index.mjs +85 -0
- package/scripts/sync-plugin-install.mjs +223 -0
- package/scripts/sync-plugin.mjs +279 -0
- package/scripts/verify-prestep.mjs +100 -0
- package/skills/dev/audit-rule-authoring.md +58 -0
- package/skills/dev/dsh-git-push.md +323 -0
- package/skills/dev/git-push-live-fix.md +45 -0
- package/skills/dsh-repo-index.md +35 -0
- package/skills/guide/guide-audit.md +167 -0
- package/skills/guide/guide-cli-scripts.md +104 -0
- package/skills/guide/guide-clone-repos.md +173 -0
- package/skills/guide/guide-commit-push.md +156 -0
- package/skills/guide/guide-inject-ui.md +166 -0
- package/skills/guide/guide-slash-completion.md +118 -0
- package/skills/workflow/README.md +21 -0
- package/skills/workflow/git-commit-discipline.md +68 -0
- package/skills/workflow/git-project-startup.md +85 -0
- package/skills/workflow/git-rebuild-process.md +57 -0
- package/skills/workflow/github-operations.md +91 -0
- package/skills/workflow/readme-sync-git-md.md +28 -0
- package/skills/workflow/task-completion-report.md +73 -0
- package/skills/workflow/tool-json-add-ask.md +35 -0
- package/skills/workflow/versioning-rule.md +211 -0
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: guide-slash-completion
|
|
3
|
+
description: dsh-git-push 功能说明:斜杠命令与任务收尾(收尾格式、✅ 即授权推送)。处理斜杠命令与收尾汇报类请求时加载。
|
|
4
|
+
whenToUse: 要在输入框用 /git-* 命令,或需要标准任务收尾汇报格式时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 斜杠命令与任务收尾(guide-slash-completion)
|
|
10
|
+
|
|
11
|
+
> 一句话定位:**输入框里能直接敲的只读查询命令 + 每个任务收尾时的标准汇报格式**——前者给人快速自查,后者让交付有据可查、并决定能否推送。
|
|
12
|
+
|
|
13
|
+
## 一、斜杠命令(6 条,全部只读)
|
|
14
|
+
|
|
15
|
+
会话输入框敲 `/` 会弹出发现菜单,本插件注册以下命令:
|
|
16
|
+
|
|
17
|
+
| 命令 | 作用 | 参数 | 示例 |
|
|
18
|
+
|------|------|------|------|
|
|
19
|
+
| `/git-audit` | 审计仓库(规则检查 + 质量评分) | `[路径] [--full]` | `/git-audit`(审当前工作区本次变动)、`/git-audit <repo> --full` |
|
|
20
|
+
| `/git-scan` | 列出各仓库分支 / 未提交 / 未推送 | `[路径]` | `/git-scan` |
|
|
21
|
+
| `/git-io-scan` | 扫描脚本里的文件读写调用与路径,标四级风险 | `[路径] [--write]` | `/git-io-scan --write` |
|
|
22
|
+
| `/link-check` | 检查文档内链接有效性 | `[文件或目录]` | `/link-check README.md` |
|
|
23
|
+
| `/git-account` | 校验 GitHub 账号与凭据 | — | `/git-account` |
|
|
24
|
+
| `/git-clone-preview` | 预览 clone 将下载 / 跳过哪些文件(**不落盘**) | `<owner/repo> [--branch 名]` | `/git-clone-preview EIGHTfs/dsh-git-push` |
|
|
25
|
+
|
|
26
|
+
**为什么只有只读命令**:输入框一条命令就改远端(提交、建仓、改可见性)风险过高——写类操作一律走 agent 工具,会经过审计门禁、开发者要求清单与推送门禁。唯一与远端交互的是 `/git-clone-preview`,它只读远端文件树回报将下载什么,不下载、不落盘。
|
|
27
|
+
|
|
28
|
+
### 共同规则
|
|
29
|
+
|
|
30
|
+
- **默认路径 = 当前会话工作区**;`/git-scan` 不带路径时用插件配置的默认扫描根
|
|
31
|
+
- **未分类会话**(无工作区)必须写路径,否则报错退出——不会去扫 DSH 家根
|
|
32
|
+
- 相对路径接到会话工作区;无工作区时只能用绝对路径
|
|
33
|
+
- `/git-audit` 的目标必须是 git 仓库(含 `.git` 或向上能找到仓库根);非仓库直接拒绝
|
|
34
|
+
- `/git-io-scan` 与审计的 `robustness/io-risk` 同一套 AST 四级标准,默认跳过注释行
|
|
35
|
+
- 结果只显示在命令层,**不进模型历史**(官方命令协议)
|
|
36
|
+
- 改动命令注册后需**重启实例**,输入框才会出现新命令
|
|
37
|
+
|
|
38
|
+
## 二、任务收尾汇报(硬约定)
|
|
39
|
+
|
|
40
|
+
每个有交付物或实质结论的任务,回复结尾必须用**一整行 ═ 分隔线**收尾,并给出状态标记与三要素:
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
══════════════════════════
|
|
44
|
+
✅ 任务完成
|
|
45
|
+
|
|
46
|
+
交付:
|
|
47
|
+
- <文件路径 / 功能 / 结论>
|
|
48
|
+
|
|
49
|
+
验证:
|
|
50
|
+
<实测通过 / 单测通过 / 待人工确认——必须如实>
|
|
51
|
+
|
|
52
|
+
遗留:
|
|
53
|
+
<已知边界 / 待办 / 坑;没有可省略>
|
|
54
|
+
══════════════════════════
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
| 状态 | 什么时候用 |
|
|
58
|
+
|------|-----------|
|
|
59
|
+
| ✅ 任务完成 | 目标达成、验证过 |
|
|
60
|
+
| ⚠️ 未完成 | 部分达成、有明确遗留 |
|
|
61
|
+
| ❌ 失败 | 没达成且已确认原因 |
|
|
62
|
+
|
|
63
|
+
纯咨询、闲聊可简化为一行「✅ 已解答」。
|
|
64
|
+
|
|
65
|
+
### 两个配套工具
|
|
66
|
+
|
|
67
|
+
| 工具 | 用途 | 参数 |
|
|
68
|
+
|------|------|------|
|
|
69
|
+
| `task_completion_render` | 渲染标准收尾块(分隔线 + 状态 + 三要素),把返回值原样贴到回复结尾 | `delivered`、`verified`、`remaining`、`status`(done/partial/failed) |
|
|
70
|
+
| `task_completion_check` | 自检一段收尾文本是否符合格式(分隔线/完成标记/交付/验证/遗留),返回缺失项 | `text` |
|
|
71
|
+
|
|
72
|
+
推荐流程:先写正文 → 调 `task_completion_render` 拿收尾块 → 贴到结尾(必要时用 `task_completion_check` 自检)。
|
|
73
|
+
|
|
74
|
+
## 三、✅ 即授权推送
|
|
75
|
+
|
|
76
|
+
**回复中出现 `✅ 任务完成` 这个标记,即视为对本轮改过的仓库授权 `commit + push`。**
|
|
77
|
+
|
|
78
|
+
边界:
|
|
79
|
+
|
|
80
|
+
- 只授权**本会话改过的**仓库,不是全机扫描出的所有仓库
|
|
81
|
+
- 只授权**本次任务范围**的改动,不含顺手夹带的无关改动
|
|
82
|
+
- 没写收尾块、或写的是 ⚠️/❌ 时,**不构成推送授权**——此时推送仍需单独征得同意
|
|
83
|
+
- 提交前仍要过插件自己的门禁:审计拦截、开发者要求清单(提交信息写清做了什么、敏感信息不入库、README 同步等)
|
|
84
|
+
|
|
85
|
+
## 四、可直接复制的例子
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
# 输入框里自查(不进模型历史)
|
|
89
|
+
/git-audit
|
|
90
|
+
/git-scan
|
|
91
|
+
/git-io-scan --write
|
|
92
|
+
/link-check README.md
|
|
93
|
+
/git-account
|
|
94
|
+
/git-clone-preview ww-rm/azurlane_spinepainting
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
# 收尾(agent 侧)
|
|
99
|
+
task_completion_render({
|
|
100
|
+
delivered: "修复克隆断点续传:分片不再每轮被清空",
|
|
101
|
+
verified: "新增回归测试 2/2 通过,回退修复即失败",
|
|
102
|
+
remaining: "宿主需重启后生效",
|
|
103
|
+
status: "partial",
|
|
104
|
+
})
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## 五、边界与坑
|
|
108
|
+
|
|
109
|
+
- 命令**只在输入框可用**,agent 不能调斜杠命令;agent 侧请用同名工具(`code_audit` / `git_scan` / `io_scan` / `link_check` / `git_account_check` / `git_clone_preview`)
|
|
110
|
+
- `/git-audit` 不带 `--full` 时审的是「本次变动」,工作区干净时结果会很短,属正常
|
|
111
|
+
- 收尾块里的「验证」必须如实——没实测就写「待人工确认」,不要写「实测通过」
|
|
112
|
+
- 收尾块是给人快速扫的,正文该讲的细节仍要讲,不要把全部内容塞进收尾块
|
|
113
|
+
|
|
114
|
+
## 六、相关功能
|
|
115
|
+
|
|
116
|
+
- 提交推送门禁与返回字段 → `guide/guide-commit-push`
|
|
117
|
+
- 审计规则、评分、豁免 → `guide/guide-audit`
|
|
118
|
+
- 克隆预览与续传 → `guide/guide-clone-repos`
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: git-workflow-gitpush-readme
|
|
3
|
+
description: dsh-git-push 工作流 skill 目录说明:本目录放 git 工作流约定类 skill,含来源与已内置化清单。处理「工作流 skill 在哪」类请求时加载。
|
|
4
|
+
whenToUse: 想知道 skills/git-workflow-gitpush/ 下有哪些工作流约定、从哪来、哪些已内置化时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# git 工作流 skill(dsh-git-push 相关)
|
|
10
|
+
|
|
11
|
+
> 本目录存放 git 工作流约定类 skill。按 skill 存放规则,插件相关 skill 的唯一位置是插件项目的 `skills/`。
|
|
12
|
+
|
|
13
|
+
## 来源
|
|
14
|
+
|
|
15
|
+
- 由独立的 git 工作流规则文档整合进插件项目 `skills/`
|
|
16
|
+
- 这些 `.md` 通过插件的「skill 目录注入」进入会话(collectRepoSkillDirs)
|
|
17
|
+
|
|
18
|
+
## 已内置化
|
|
19
|
+
|
|
20
|
+
- 开发者要求清单 → `lib/user-requirements.json`(随插件分发;v2 未移植,待验收)
|
|
21
|
+
- 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.json`)
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: git-commit-discipline
|
|
3
|
+
description: 提交纪律:什么时候必须提交(批量/移动删除/整理/skill 变动/检查点)、提交信息怎么写、提交与推送的边界。处理提交时机与写法类请求时加载。
|
|
4
|
+
whenToUse: 要做批量文件操作、移动/删除、整理目录、改 skill、测试通过想保存进度、写 commit message 时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 提交纪律(git-commit-discipline)
|
|
10
|
+
|
|
11
|
+
> 核心一句话:**有副作用的操作前先提交检查点;提交信息写清「改了什么 + 功能进度」;提交可自主,推送要授权。**
|
|
12
|
+
|
|
13
|
+
## 一、什么时候必须提交
|
|
14
|
+
|
|
15
|
+
| 场景 | 动手前必做 |
|
|
16
|
+
|------|------------|
|
|
17
|
+
| 批量文件操作(复制/删除/移动/重命名/覆盖 ≥3 个) | 先 `git add -A` + `git commit`(检查点,不推送)再操作 |
|
|
18
|
+
| 移动 / 删除文件目录 | 先问是否建本地 git 还原点;同意则先 commit 再执行(用户说不用则跳过,但删除仍走回收站) |
|
|
19
|
+
| 整理文件 / 目录 / 归档归类 / 清理散落文件 | **任务第一步**就是提交检查点(不等批量操作时才做) |
|
|
20
|
+
| skill 新增 / 修改 / 删除 / 重命名 | 当场提交到它所在仓库(通用 skill → 技能仓库;插件 skill → 插件项目),不等批量、不等收尾 |
|
|
21
|
+
| 测试通过想保存进度 | 随时可 commit 作检查点(防丢失、留回退锚点) |
|
|
22
|
+
| 正式推送前 | 撤销零散提交(`git reset --soft <基线>`)→ 重写规范 README + 整理提交记录 → 一次干净提交 |
|
|
23
|
+
|
|
24
|
+
非 git 目录:无法建还原点,如实告知,改用备份(`cp -r` 到备份目录);删除一律走回收站(`.trash`,可恢复),禁止 `rm -rf` 永久删除。
|
|
25
|
+
|
|
26
|
+
为什么:批量/整理/删除是副作用放大区,一次可能动几十上百个文件,误判难手工恢复;检查点是唯一可靠还原点,也让「改了什么」的 diff 清晰。
|
|
27
|
+
|
|
28
|
+
## 二、提交信息怎么写
|
|
29
|
+
|
|
30
|
+
两部分:**本次变更** + **功能进度三态**。
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
<type>(<scope>): 本次变更摘要
|
|
34
|
+
|
|
35
|
+
功能进度:
|
|
36
|
+
- 开发中:<功能A>、<功能B>
|
|
37
|
+
- 已开发完:<功能C>、<功能D>
|
|
38
|
+
- 未开始:<功能E>、<功能F>(无则写「无」)
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
- type:feat / fix / docs / chore / skill 等;摘要写清**做了什么**,禁止「update」「改了点东西」这类空泛词
|
|
42
|
+
- 三态按**当前真实进度**写,不照抄上次;完成一个就从「开发中」移到「已开发完」
|
|
43
|
+
- 小改动同样带三态(可精简);推送前重写提交时,三态同步刷新
|
|
44
|
+
- 效果:`git log` 一拉就是项目进度快照,接手的人不用翻 README
|
|
45
|
+
|
|
46
|
+
## 三、提交 vs 推送
|
|
47
|
+
|
|
48
|
+
| 动作 | 授权 |
|
|
49
|
+
|------|------|
|
|
50
|
+
| commit | 可自主执行(测试通过即可,作检查点) |
|
|
51
|
+
| push | **必须先获授权**(用户明确同意,或回复中出现「✅ 任务完成」收尾标记) |
|
|
52
|
+
|
|
53
|
+
推送前必做:README 与实现对齐(功能表、版本记录、设计/地址章节)、提交记录整理成「一个逻辑变更 = 一个提交」、文档不含对话引用与未脱敏内容。
|
|
54
|
+
|
|
55
|
+
## 四、坑
|
|
56
|
+
|
|
57
|
+
- 提交漏了 `git add -A` 或漏新文件 → 提交不完整,回退时丢文件
|
|
58
|
+
- 未授权就 push → 违反推送纪律(推送前还要做整理)
|
|
59
|
+
- 批量操作前忘了提交 → 出错只能靠回收站逐个恢复,没有整体回退点
|
|
60
|
+
- 非 git 目录硬要建还原点 → 如实说明改用备份,别假称已备份
|
|
61
|
+
|
|
62
|
+
## 五、配套 skill
|
|
63
|
+
|
|
64
|
+
- `git-project-startup`:开工先对齐远端、读提交历史
|
|
65
|
+
- `github-operations`:GitHub 通道与项目恢复
|
|
66
|
+
- `versioning-rule`:版本号语义(推送前同步版本号)
|
|
67
|
+
- `safe-delete-trash`:删除进回收站可恢复
|
|
68
|
+
- `bugfix-auto-authority`:commit 可自主、push 需同意
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: git-project-startup
|
|
3
|
+
description: 项目开工三件事:先和远端对齐、再读提交历史、发现他人改动先审查后接纳。处理项目开工/接手/协作冲突类请求时加载。
|
|
4
|
+
whenToUse: 任何项目开工、接手、继续开发、排查状态前;git 里发现他人改动或冲突时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 项目开工与协作(git-project-startup)
|
|
10
|
+
|
|
11
|
+
> 核心一句话:**开工第一件事是和远端对齐,第二件事是读提交历史,开发中发现他人改动先审查再接纳。**
|
|
12
|
+
|
|
13
|
+
## 一、开工第一步:和远端对齐
|
|
14
|
+
|
|
15
|
+
**开工的第一个动作 = 和远端对齐**,不是写代码、不是建目录、不是 `git add`。
|
|
16
|
+
|
|
17
|
+
| 场景 | 开工前第一动作 |
|
|
18
|
+
|------|----------------|
|
|
19
|
+
| git 仓库(GitHub 或任何远端 git) | 先 `git fetch` 看远端是否被推进 → 有差异先 `pull` 对齐 → 确认一致再开工 |
|
|
20
|
+
| 非 git 远端(SFTP / rsync / 共享目录) | 先拉取或对比远端(`rsync -avn` dry-run / `sftp` 列目录 / 比对 mtime),确认一致再动手 |
|
|
21
|
+
| 新项目(尚无远端) | 先确认远端是否存在/连通,有则先拉下来,无则先初始化 |
|
|
22
|
+
| 继续开发 / 排查 | 先对齐远端,再读提交历史(读历史是第二步) |
|
|
23
|
+
| 用户明确说不用对齐 | 按用户指令跳过 |
|
|
24
|
+
|
|
25
|
+
为什么:防基于过时基线开发(白干 + 必冲突)、防本地旧状态覆盖远端新内容、防多机多会话各自为战;**远端不止 GitHub**,SFTP / 共享盘 / rsync 目录同样是远端真相。
|
|
26
|
+
|
|
27
|
+
| 远端类型 | 对齐动作 | 注意 |
|
|
28
|
+
|----------|----------|------|
|
|
29
|
+
| GitHub | `git fetch` → 看 `origin/<branch>` 差异 → pull | 禁止 `github.com` 直连,走 api.github.com;token 失效走 `ssh.github.com:443` |
|
|
30
|
+
| 任意 git remote | `git fetch` + `git log HEAD..origin/<branch>` | 远端领先必须拉,禁止先 push |
|
|
31
|
+
| SFTP | 列远端目录 / 对比 | 先读远端,不先写远端 |
|
|
32
|
+
| rsync 目录 | `rsync -avn` dry-run 先看差异 | dry-run 先行 |
|
|
33
|
+
| 共享盘 / 挂载目录 | 比对两端 mtime / 文件清单 | 双向都可能改,先确认哪边新 |
|
|
34
|
+
|
|
35
|
+
对齐完成后**必须汇报**:远端有哪些本地没有的变更、已同步了什么。对齐是「拉」不是「推」,推送仍需授权。
|
|
36
|
+
|
|
37
|
+
## 二、第二动作:读提交历史
|
|
38
|
+
|
|
39
|
+
| 场景 | 动作 |
|
|
40
|
+
|------|------|
|
|
41
|
+
| 用户说「进项目读提交历史 / 看下这项目提交」 | 进目录跑 `git log`,读完汇报要点;**禁止只报 commit 数或摘要** |
|
|
42
|
+
| 接手 / 了解项目 | 读分支 + 最近 N 条提交 + 提交信息类型,从提交信息看项目脉络 |
|
|
43
|
+
| 排查项目状态 | 先看最近提交在做什么(功能/修复/文档),再定排查方向 |
|
|
44
|
+
| 引用某项目提交记录 | 以实读为准(短哈希 + 提交信息),禁止凭印象编造 |
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
cd <项目目录>/<仓库名>
|
|
48
|
+
git branch --show-current # 先看分支,别假设 master
|
|
49
|
+
git log --pretty=format:"%h|%ad|%s" --date=format:"%m-%d %H:%M" -20
|
|
50
|
+
git show --stat --oneline HEAD | head -20 # 最近一次改了哪些文件
|
|
51
|
+
git show --stat <短哈希> # 某条提交的具体改动
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
- 提交信息格式:`type(scope): 描述`(feat/fix/docs/chore/skill 等)
|
|
55
|
+
- 分支:master 与 main 都有,**读之前先看分支**
|
|
56
|
+
- 汇报格式:仓库名 → 分支 → 最近活动 → 最近提交主线(3~5 条概括),让用户一眼看清每个项目最近在干什么
|
|
57
|
+
- 快速盘点所有仓库:用插件的 `git_scan`;仓库地址权威源:`dsh-repo-index`
|
|
58
|
+
|
|
59
|
+
坑:别在仓库外跑 `git log`;只看摘要不算读;项目目录顶层可能有散落脚本/产物文件(非仓库),认准有 `.git` 的子目录。
|
|
60
|
+
|
|
61
|
+
## 三、发现他人改动:先审查后接纳
|
|
62
|
+
|
|
63
|
+
**触发**:`git pull` 后出现非自己的提交、`git status`/`git diff` 显示自己没改过的改动、merge 冲突、文件被覆盖。判定关键是「**作为本来的开发者却不知道**」——出现陌生改动就必须查对方改了什么、为什么、有没有 bug。
|
|
64
|
+
|
|
65
|
+
审查流程:
|
|
66
|
+
|
|
67
|
+
1. 识别范围:`git log --oneline -10`、`git log --name-status -3`、`git diff origin/<branch>..HEAD --stat`、`git status --short`
|
|
68
|
+
2. 定位改动:`git log --all --oneline -- <file>`、`git diff <他人commit>~1 <他人commit> -- <file>`
|
|
69
|
+
3. **优先查对方 bug**(不跳过):是否破坏自己已实现的功能/约定(API 签名、字段名、端口、路径、配置键、时序)、是否引入明显错误、是否违反本工作区 skill 约定;逐项列出「改了什么 → 潜在 bug → 影响」
|
|
70
|
+
4. 处理:有 bug → 指出并修复(或回退并说明);正确 → 采纳后继续;与自己冲突 → 保留自己版本并说明冲突点,必要时问用户
|
|
71
|
+
5. 固化:把「冲突 + 对方 bug + 处理方式」提炼进对应 skill
|
|
72
|
+
|
|
73
|
+
典型教训:并行会话容易互踩(同一配置文件/入口文件被覆盖)→ pull 前先 `git fetch` 看远端是否被推进;「写了没测试」的他人改动,审查时核对验证状态是否属实,不轻信 commit message;同一文件两份副本不同步时,以权威源为准。
|
|
74
|
+
|
|
75
|
+
## 四、元规则:skill 是强约束
|
|
76
|
+
|
|
77
|
+
本工作区固化的所有 skill(尤其约定类)**对所有 AI 所有会话生效**,是必须遵守的规则而不是参考文档;任何 AI 在做相关操作前必须加载并遵守。新建/更新 skill 后按存放规则同步并提交。
|
|
78
|
+
|
|
79
|
+
## 五、配套 skill
|
|
80
|
+
|
|
81
|
+
- `github-operations`:GitHub 操作通道(api.github.com)与项目恢复
|
|
82
|
+
- `git-commit-discipline`:提交检查点、批量操作前提交、提交信息规范
|
|
83
|
+
- `dsh-repo-index`:仓库地址与可见性权威源
|
|
84
|
+
- `verify-before-diagnose`:排查先实测
|
|
85
|
+
- `bugfix-auto-authority`:commit 可自主、push 需同意
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: git-rebuild-process
|
|
3
|
+
description: 重新建库流程(2026-08-21 EIGHTfs 确立,权威;权威源 = dsh-git-push 插件项目 skills/)——在数据文件夹新建 git 仓库 → 按原始项目每次提交重新分析合理提交点 → 建立长期任务分步骤按顺序还原到提交点复制进新 git → 走 gitpush 提交流程(不推送)→ 全部转移完成推送 → 仓库移到根目录(.dsh 同级)「项目」文件夹。处理「重新建库」「重建仓库」「按提交点还原重建」「迁移仓库到项目文件夹」类任务时加载。
|
|
4
|
+
whenToUse: 用户说「重新建库/重建仓库」、原仓库需按提交历史重梳理还原、项目仓库要迁移到「项目」文件夹、需要分步骤按提交点重建 git 时。
|
|
5
|
+
generatedBy: EIGHTfs 2026-08-21(规则整理;权威归属 = dsh-git-push 插件权威 skill)
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 重新建库流程(git-rebuild-process)
|
|
9
|
+
|
|
10
|
+
> 2026-08-21 用户(EIGHTfs)确立。开发者文档留档:`ai-work-archive/开发者文档/重新建库流程-20260821.md`。
|
|
11
|
+
> 配套:dsh-git-push(提交纪律)、commit-checkpoint-before-push-reorg(推送前整理)、multi-task-todo-queue(长期任务)、task-data-dirs-rule(目录纪律)、versioning-rule(版本号)。
|
|
12
|
+
|
|
13
|
+
## 一、流程(7 步,按序执行)
|
|
14
|
+
|
|
15
|
+
1. **建库**:在数据文件夹新建 git 仓库(`/vol1/@appshare/DeepSeekHarness/数据/`,可建子目录如 `数据/重建仓库`)
|
|
16
|
+
2. **分析提交点**:按原始项目**每次提交**重新分析合理提交点(原始提交可能杂乱,重梳理出有意义的 commit 点)——**提交点判定细则见第五节**
|
|
17
|
+
3. **长期任务**:建立任务清单,分步骤按顺序还原到提交点
|
|
18
|
+
4. **还原+复制**:每步还原一个提交点的文件状态 → 复制进新建 git
|
|
19
|
+
5. **提交**:新建 git 走 dsh-git-push 提交流程——**只 commit 不推送**
|
|
20
|
+
6. **推送**:全部转移完成后才推送新位置的仓库
|
|
21
|
+
7. **归位**:仓库移到根目录(.dsh 同级)「项目」文件夹(`/vol1/@appshare/DeepSeekHarness/项目/`)
|
|
22
|
+
|
|
23
|
+
## 二、目录约定
|
|
24
|
+
|
|
25
|
+
| 名称 | 路径 | 角色 |
|
|
26
|
+
|------|------|------|
|
|
27
|
+
| 数据文件夹 | `/vol1/@appshare/DeepSeekHarness/数据/` | 重建暂存 git 位置 |
|
|
28
|
+
| 根目录(.dsh 同级) | `/vol1/@appshare/DeepSeekHarness/` | 归位上级 |
|
|
29
|
+
| 项目文件夹 | `/vol1/@appshare/DeepSeekHarness/项目/` | 重建后仓库最终位置(2026-08-21 新建,0700) |
|
|
30
|
+
|
|
31
|
+
## 三、纪律
|
|
32
|
+
|
|
33
|
+
- git 纪律:**未同意不推送**;提交可自主作检查点(bugfix-auto-authority)
|
|
34
|
+
- 推送前可撤销整理 README/提交记录再正式提交推送(commit-checkpoint-before-push-reorg)
|
|
35
|
+
- 长期任务分步骤不跳序(multi-task-todo-queue)
|
|
36
|
+
- 还原 = 复制不动原始项目,全程可回退
|
|
37
|
+
|
|
38
|
+
## 四、合理提交点判定(2026-08-21 用户补充,权威)
|
|
39
|
+
|
|
40
|
+
> **核心**:提交点 = **推送过的主版本**(feat/功能里程碑);**推送过后修复过 bug 的提交不能算合理提交点**,应并入其所属主版本。
|
|
41
|
+
|
|
42
|
+
### 判定细则
|
|
43
|
+
|
|
44
|
+
1. **主版本 = 合理提交点**:源仓库中带版本号的 **feat/功能** 提交(如带版本号的 feat/功能提交)= 提交点骨架
|
|
45
|
+
2. **修复不单独成点**:推送(发布)后针对该版本修 bug 的提交(fix/补丁版本)**不能算合理提交点**——并入其主版本提交点,不单独拆开
|
|
46
|
+
3. **并入方式**:提交点取「主版本线的最终状态」文件树(含修复内容);package.json 版本修正为**主版本号**;commit message 注明并入的修复(如 `主版本号(含修复说明)`)
|
|
47
|
+
4. **docs/清理/跨项目杂项提交**:按时间就近并入相邻主版本提交点(内容随文件树自然包含),不单独成点
|
|
48
|
+
5. **版本号规范**:提交点版本号遵循 versioning-rule(1 开头、X.Y.Z、版本只在提交时变化);源仓库漏 bump 的按规范修正(如 1.13.1 修复并入 1.13.0 时版本号归 1.13.0)
|
|
49
|
+
6. **初始提交**:无代码文档版 = 1.0.0(原理/架构/规划文档,最新规范定义)
|
|
50
|
+
|
|
51
|
+
### 反例(2026-08-21 dsh-git-rescue 1.x 重建实测)
|
|
52
|
+
|
|
53
|
+
- ❌ 把修复版本拆成独立提交点
|
|
54
|
+
- ✅ 修复并入主版本后 13 个提交点:1.0.0 + 1.2.0(含 1.2.1/1.2.2 修复)→1.3.0→1.4.0(含 1.4.1)→1.5.0(含 1.5.1)→1.6.0→1.7.0(含 1.7.1/1.7.2)→1.8.0→1.9.0→1.10.0→1.11.0→1.12.0→1.13.0(含 1.13.1)
|
|
55
|
+
|
|
56
|
+
## 相关
|
|
57
|
+
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: github-operations
|
|
3
|
+
description: GitHub 操作规则:全走 api.github.com、项目丢失从 GitHub 恢复、置顶仓库(无 API 只能网页操作)。处理 GitHub 操作类请求时加载。
|
|
4
|
+
whenToUse: 要访问 GitHub、项目/插件源码本地丢失需重新拉取、或要置顶仓库/展示代表作时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# GitHub 操作(github-operations)
|
|
10
|
+
|
|
11
|
+
> 核心一句话:**GitHub 一切操作走 `api.github.com`(token 失效回退 `ssh.github.com:443`),永远不走 `github.com`;项目丢了就去 GitHub 找;置顶只能网页手动。**
|
|
12
|
+
|
|
13
|
+
## 一、铁律:全走 api.github.com
|
|
14
|
+
|
|
15
|
+
实测结论:本机网络下 `api.github.com:443` 通、`github.com:443` 超时(两者是独立边缘节点,把 `github.com` 强解析到 api 的 IP 也会被拒)。dsh-git-push 的 clone / push / 建仓 / 可见性 / 打 tag 全部走 GitHub API,不跟随 302 到 codeload。
|
|
16
|
+
|
|
17
|
+
### 允许(走 api.github.com)
|
|
18
|
+
|
|
19
|
+
| 操作 | 端点 |
|
|
20
|
+
|------|------|
|
|
21
|
+
| 下载仓库 ZIP | `GET /repos/{owner}/{repo}/zipball/{ref}` |
|
|
22
|
+
| 下载 Release 文件 | `GET /repos/{owner}/{repo}/releases` |
|
|
23
|
+
| 查看文件内容 | `GET /repos/{owner}/{repo}/contents/{path}` |
|
|
24
|
+
| 查看目录树 | `GET /repos/{owner}/{repo}/git/trees/{sha}?recursive=1` |
|
|
25
|
+
| 搜索仓库 | `GET /search/repositories?q={keyword}` |
|
|
26
|
+
| 查看 Issue / PR | `GET /repos/{owner}/{repo}/issues` |
|
|
27
|
+
| 查看分支 / 提交 / Actions | `/branches`、`/commits`、`/actions/runs` |
|
|
28
|
+
| push(token 失效时) | `ssh://git@ssh.github.com:443/{owner}/{repo}.git` |
|
|
29
|
+
|
|
30
|
+
### 禁止(走 github.com)
|
|
31
|
+
|
|
32
|
+
| 操作 | 原因 |
|
|
33
|
+
|------|------|
|
|
34
|
+
| `git clone https://github.com/...` | git 协议走 github.com,不通 |
|
|
35
|
+
| 浏览器访问 `https://github.com/...` | 网页版不通 |
|
|
36
|
+
| `raw.githubusercontent.com` | 不同域名,可能不通(插件仅在续传时尝试) |
|
|
37
|
+
|
|
38
|
+
必须拿代码时:用 API 下 ZIP 再解压,或直接用插件的 `git_clone`(走 Git Data API,不直连 github.com)。
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# 连通性与限流自查
|
|
42
|
+
curl -sI --connect-timeout 5 https://api.github.com/rate_limit | head -3
|
|
43
|
+
curl -s "https://api.github.com/rate_limit" | jq '.resources.core'
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## 二、项目丢失从 GitHub 恢复
|
|
47
|
+
|
|
48
|
+
| 项 | 内容 |
|
|
49
|
+
|----|------|
|
|
50
|
+
| 触发 | 项目/插件源码本地不存在:目录丢失、损坏、新机未克隆、迁移后缺文件 |
|
|
51
|
+
| 默认动作 | 去用户 GitHub 账号找对应仓库并克隆回来(优先用插件的 `git_clone`) |
|
|
52
|
+
| 地址权威源 | `dsh-repo-index`(仓库地址 / 可见性 / 恢复命令的唯一权威)——不凭记忆写地址 |
|
|
53
|
+
| 找不到时 | 如实告知「GitHub 也没有」→ 查部署副本(node_modules)、本地备份,或询问用户 |
|
|
54
|
+
| 归属判定 | 以 `dsh-repo-index` 清单为准;个别项目随主仓库打包分发,但源码仍是独立仓库 |
|
|
55
|
+
|
|
56
|
+
步骤:查 `dsh-repo-index` 确认仓库与可见性 → 公开仓库直接克隆,私有仓库带凭据(插件自动注入,**不要手抄 token**)→ 恢复后按插件的安装流程装回主环境。
|
|
57
|
+
|
|
58
|
+
边界:**无 GitHub 远端的项目**(本地 only)找不回来,如实告知,不凭空说找到了;仓库名与本地目录名可能不同,以索引为准;新机恢复顺序是「先 skill → 再项目 → 最后会话」。
|
|
59
|
+
|
|
60
|
+
## 三、置顶仓库(无 API,只能网页)
|
|
61
|
+
|
|
62
|
+
硬性事实:GitHub REST 与 GraphQL 都只能**读取**置顶状态(GraphQL 的 `pinnedAt` / `Pinnable`),没有任何写置顶的接口;社区所谓「脚本置顶」是浏览器自动化模拟点击,不建议代跑。所以接「帮我置顶 XX」时,可交付的是:精确步骤 + 文案素材 + 替代展示方案,最后一步由用户在浏览器点。
|
|
63
|
+
|
|
64
|
+
步骤(约 30 秒):
|
|
65
|
+
|
|
66
|
+
1. 打开 `https://github.com/<用户名>` → Pinned 区 → **Customize your pins**
|
|
67
|
+
2. 勾选要置顶的仓库(上限 **6 个**)→ **Save pins**
|
|
68
|
+
3. 点卡片 ✏️ 可写**自定义简介**(显示在仓库名下方)
|
|
69
|
+
|
|
70
|
+
| 对象 | 能否置顶 |
|
|
71
|
+
|------|----------|
|
|
72
|
+
| 自己的仓库 | ✅ 最多 6 个,公开/私有均可(私有仅自己可见),无需 Star |
|
|
73
|
+
| Gist | ✅ 主页 Pinned 区同样可 pin |
|
|
74
|
+
| 别人的仓库 | ❌ 只能 Star / 加列表 |
|
|
75
|
+
| Trending 榜单 | ❌ 无法手动设置,由 Star 增速与社区热度决定 |
|
|
76
|
+
|
|
77
|
+
6 个位不够时用 **Profile README**:建与用户名同名仓库 `<用户名>/<用户名>`,README 写自我介绍 + 代表作列表,展示在主页顶部(比置顶区更靠前);可配 github-readme-stats 卡片、shields.io 徽章、项目表格。
|
|
78
|
+
|
|
79
|
+
## 四、边界与坑
|
|
80
|
+
|
|
81
|
+
- 不要把「置顶无 API」解释成「接口坏了 / 404」——是没有这个能力
|
|
82
|
+
- 私有仓库置顶对访客无意义:接置顶任务先确认仓库公开
|
|
83
|
+
- 私有仓库克隆必须带凭据,无凭据必失败;凭据由插件托管,不要手抄进命令行或文档
|
|
84
|
+
- 恢复前先确认目标目录是否已存在(可能只是路径变了,而不是真丢了)
|
|
85
|
+
|
|
86
|
+
## 五、配套 skill
|
|
87
|
+
|
|
88
|
+
- `dsh-repo-index`:仓库地址 / 可见性唯一权威
|
|
89
|
+
- `git-project-startup`:开工前先读提交历史、先与远端对齐
|
|
90
|
+
- `readme-craft`:README 写作与包装
|
|
91
|
+
- `check-local-before-download` / `network-check-before-download`:下载前先查本地、先测网络
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: readme-sync-git-md
|
|
3
|
+
description: 写 README 必须转述 git 提交涉及的 md 内容(禁止只写文件名),且 README 与代码/提交不得脱节。处理写 README 类请求时加载。
|
|
4
|
+
whenToUse: 写/更新 README、发布文档,或发现 README 与提交、代码对不上时。
|
|
5
|
+
updated: 2026-10-02
|
|
6
|
+
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 写 README 必须转述 git 提交 md 内容(readme-sync-git-md)
|
|
10
|
+
|
|
11
|
+
> 核心一句话:README 要成为「git 提交里那些 md 的内容汇集入口」,而不是一份文件清单。
|
|
12
|
+
|
|
13
|
+
## 一、规则
|
|
14
|
+
|
|
15
|
+
任何「写 README / 更新 README / 发布文档」任务,必须:
|
|
16
|
+
|
|
17
|
+
| 步骤 | 必须做的 |
|
|
18
|
+
|------|----------|
|
|
19
|
+
| 1. 先查提交涉及的 md | `git log --name-only` 看最近提交改过哪些 `.md`(docs 留痕、skills 经验、提交说明),列出清单 |
|
|
20
|
+
| 2. 转述内容,不是列文件名 | 把这些 md 承载的功能/经验/教训/设计决策,用 README 自己的话整合进正文(功能表、API、路径规则、设计要点);**禁止只写「详见 docs/xxx.md」了事** |
|
|
21
|
+
| 3. 与代码/提交对齐 | README 描述的功能以实际提交的代码为准;发现 README 过时(例如写「已移除某功能」但代码仍在用)必须顺手修正 |
|
|
22
|
+
| 4. 完成后重新整理 | 新功能待办转已完成,更新功能表 / 设计 / 地址 |
|
|
23
|
+
|
|
24
|
+
## 二、配套 skill
|
|
25
|
+
|
|
26
|
+
- `git-project-read-history`:进项目先读提交历史
|
|
27
|
+
- `code-truth-over-md`:代码是真相,README 过时以代码为准
|
|
28
|
+
- `feature-todo-readme-cycle`:README 待办闭环
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: task-completion-report
|
|
3
|
+
description: dsh-git-push 使用说明:任务收尾必须用分隔线 + ✅ 任务完成 + 交付/验证/遗留;输出 ✅ 即授权对改过的仓 commit+push。处理任务收尾汇报、提交推送授权时加载。
|
|
4
|
+
whenToUse: 每次完成有交付物的任务后收尾;调用 git_commit_push 前;用户问「怎么汇报完成」「✅ 能不能推送」时。
|
|
5
|
+
generatedBy: grok-4.6 · 2026-09-03
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 任务完成汇报(dsh-git-push 使用说明)
|
|
9
|
+
|
|
10
|
+
> 权威源 = `dsh-git-push/skills/task-completion-report.md`(插件 skill,随插件版本管理)。
|
|
11
|
+
> 同时是 dsh-git-push 插件的开发者要求:调用 `git_commit_push` 前必须按本格式收尾(或即将收尾),✅ 即提交推送授权(要求清单随插件内置 `lib/user-requirements.json`,原同级仓 requirements.md 废除)。
|
|
12
|
+
> 本说明 skill 由插件作者从回复模板提取固化,作为 dsh-git-push 的使用说明与插件要求。
|
|
13
|
+
|
|
14
|
+
## 一、收尾格式(强制)
|
|
15
|
+
|
|
16
|
+
任务结束后,回复**结尾**(最后一段)必须包含:
|
|
17
|
+
|
|
18
|
+
1. **醒目分隔线**:一整行,如 `══════════════════════════`
|
|
19
|
+
2. **完成标记**:`✅ 任务完成`(失败/未完成用 `⚠️ 未完成` / `❌ 失败`,并说明卡在哪)
|
|
20
|
+
3. **三要素**(每项可省略为一行):
|
|
21
|
+
- **交付**:文件路径 / 功能 / 结论
|
|
22
|
+
- **验证**:实测通过 / 单测通过 / 待人工确认(必须如实)
|
|
23
|
+
- **遗留**:已知边界 / 待办 / 坑
|
|
24
|
+
|
|
25
|
+
示例:
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
══════════════════════════
|
|
29
|
+
✅ 任务完成(项目:dsh-git-push)
|
|
30
|
+
|
|
31
|
+
交付:`dsh-git-push/skills/task-completion-report.md`(收尾模板)
|
|
32
|
+
验证:单测/语法自检按本次改动跑过则如实写
|
|
33
|
+
遗留:无
|
|
34
|
+
══════════════════════════
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
要点:醒目;如实区分实测/单测/待确认;三要素各一两行;用户用中文就中文;失败也要汇报。纯闲聊可用一行 `✅ 已解答`。
|
|
38
|
+
|
|
39
|
+
## 二、项目归属
|
|
40
|
+
|
|
41
|
+
收尾必须声明本次属于哪个项目/仓库。跨项目分别写主项目 / 涉及项目。归属按 Group、cwd、用户明示的项目名。
|
|
42
|
+
|
|
43
|
+
## 三、✅ = 提交推送授权
|
|
44
|
+
|
|
45
|
+
> 规则(2026-08-18 确立):AI 输出 `✅ 任务完成` 即代表对改过的仓库提交推送授权。
|
|
46
|
+
|
|
47
|
+
- 输出 `✅ 任务完成` 后,**默认即获授权**对改过的每个 git 仓 `git_commit_push`(commit + push),不必再问「可以提交吗」
|
|
48
|
+
- 配套 `commit-push-modified-projects`:漏仓不算完成
|
|
49
|
+
- 走插件工具 `git_commit_push`,不手敲 git;开发者要求清单(内置 `lib/user-requirements.json`,可外挂插件配置目录 `requirements.json`)逐条核对后带 `requirementsConfirmed:true`
|
|
50
|
+
- **不在此授权内**:删远端仓库、force push、改生产配置、覆盖他人未拉取的历史、把凭据推进**公开**仓
|
|
51
|
+
|
|
52
|
+
## 四、推送后必须把远端最近 3 次发给用户
|
|
53
|
+
|
|
54
|
+
> 约定:每次推送远端后,把远端库最近 3 次推送的 head、标题、推送时间发给作者。
|
|
55
|
+
|
|
56
|
+
`git_commit_push` 成功后结果里有 `remoteHeads.heads` 和 `remoteHeadsText`(Markdown 表格)。收尾或推送汇报里必须用**表格**发给作者(约定:回复用表格形式),优先原样贴 `remoteHeadsText`:
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
**远端最近 3 次(owner/repo)**
|
|
60
|
+
|
|
61
|
+
| # | SHA | 标题 | 时间 |
|
|
62
|
+
|---|-----|------|------|
|
|
63
|
+
| 1 | `abcdef1` | feat: xxx | 2026-09-03T01:00:00Z |
|
|
64
|
+
| 2 | `bbbbbbb` | fix: yyy | 2026-09-02T01:00:00Z |
|
|
65
|
+
| 3 | `ccccccc` | docs: zzz | 2026-09-01T01:00:00Z |
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
拉不到时写明 `remoteHeads.error`,不要假装有。禁止改成编号列表。
|
|
69
|
+
|
|
70
|
+
## 相关
|
|
71
|
+
|
|
72
|
+
- `dsh-git-push/skills/dsh-git-push.md`:工具参数与审计
|
|
73
|
+
- 插件配置目录 `DSH_HOME/git-push/`(原同级仓废除):开发者要求清单(内置)+ 本机凭据(私有,不随本公开仓分发)
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tool-json-add-ask
|
|
3
|
+
description: 工具 json 清单新增询问规则(2026-09-20 EIGHTfs 确立):本机新增工具(用户提到装了新工具/探测发现新工具/工具使用场景需要)时,先询问用户是否新增到工具 json 清单,不擅自加;清单分两层——运行目录 <配置目录>/tools.json(本机探测结果,不入库、可热改)与源码区 lib/tool-probes.json 模板(随仓库提交)——源码区仅在「工作区有该工具源码/实际使用」时才追加,否则只进运行目录。处理「装了 xx 工具」「把 xx 加进工具清单」「tools.json / tool-probes.json」「探测工具」「工具清单更新」类场景时加载。
|
|
4
|
+
whenToUse: 用户提到本机装了新工具、探测发现新工具、或需要把某工具纳入环境注入清单时;改 lib/tool-probes.json 或运行目录 tools.json 前。
|
|
5
|
+
generatedBy: deepseek-v4-flash · 2026-09-20
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 工具 json 清单新增询问规则(tool-json-add-ask)
|
|
9
|
+
|
|
10
|
+
> 权威源 = `dsh-git-push/skills/tool-json-add-ask.md`(插件 skill,随插件版本管理)。
|
|
11
|
+
> 背景:dsh-git-push 环境注入的工具清单分两层——**源码区模板** `lib/tool-probes.json`(只 key、随仓库提交,决定探测范围)与**运行目录结果** `<配置目录>/tools.json`(key→本机实测路径,不入库、可热改)。本规则约束「什么时候、把什么加进哪一层」。
|
|
12
|
+
|
|
13
|
+
## 规则
|
|
14
|
+
|
|
15
|
+
1. **先问,不擅自加**:本机出现新增工具信号(用户说「装了 xx」「用 xx 处理」、探测发现新工具、工具使用场景需要某工具)时,先用 `ask_user_question` 询问是否把它纳入工具 json 清单——列候选工具名与两层落点,用户确认后再动。
|
|
16
|
+
|
|
17
|
+
2. **两层落点不同**:
|
|
18
|
+
- **运行目录** `<配置目录>/tools.json`(本机探测结果,不入库、可热改):任何本机已装工具都可进——改 `lib/tool-probes.json` 模板后由探测落盘,或直接热改 tools.json。
|
|
19
|
+
- **源码区** `lib/tool-probes.json` 模板(随仓库提交,决定所有机器探测范围):**仅限「工作区有该工具的源码/实际使用」才追加**——项目代码里 import 了该工具(如 playwright/puppeteer)、bin/ 或 tool/ 里有它的调用脚本、测试依赖它。工作区没有源码的纯本机工具(如临时装的 CLI),只进运行目录,**不追加进源码模板**。
|
|
20
|
+
|
|
21
|
+
3. **询问时给出两层选项**:候选工具名 + 「仅本机运行目录」/「连源码模板一起加(需工作区有源码)」/「都不加」;用户选择后执行。
|
|
22
|
+
|
|
23
|
+
4. **追加模板的提交纪律**:源码模板加了 key → 同步副本 + commit + push(git 纪律);仅运行目录 → 不入库不提交,探测结果本就只落本机。
|
|
24
|
+
|
|
25
|
+
## 实例
|
|
26
|
+
|
|
27
|
+
- ✅ 工作区 dsh-session-migrate 用到 `7z`(代码里调 7z 解压)→ 询问后把 `7z` 加进源码模板。
|
|
28
|
+
- ⚠️ 用户说「我本机装了 chromium 截图用」但当前工作区无 chromium 调用源码 → 询问后只进运行目录 tools.json,源码模板不动。
|
|
29
|
+
- 2026-09-20 实测:chromium/playwright/puppeteer 加入模板(48 key)——本机未装时探测跳过(found:false 不写盘),装了的机器重启会话后环境注入出现 `chromium=/path/to/chromium`。
|
|
30
|
+
|
|
31
|
+
## 配套
|
|
32
|
+
|
|
33
|
+
- `dsh-git-push-functions.md`(插件功能说明书:环境注入与 tools.json 机制)
|
|
34
|
+
- `skill-source-rule` / `skill-classification`(插件相关 skill 只放插件项目 skills/)
|
|
35
|
+
- `ask-with-options`(询问必须弹选项)
|