file-brief 2.0.0 → 2.0.1
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/LICENSE +21 -21
- package/README.md +25 -0
- package/package.json +1 -1
- package/skills/file-brief/agents/openai.yaml +7 -7
- package/skills/file-brief/scripts/file_catalog.py +2590 -2590
- package/skills/file-brief/scripts/inspect_r_data.R +229 -229
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Zhiyi-Zhao
|
|
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.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Zhiyi-Zhao
|
|
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,5 +1,10 @@
|
|
|
1
1
|
# file-brief
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/file-brief)
|
|
4
|
+
[](https://www.npmjs.com/package/file-brief)
|
|
5
|
+
[](LICENSE)
|
|
6
|
+
[](https://github.com/Zhiyi-Zhao/file-brief/actions/workflows/validate.yml)
|
|
7
|
+
|
|
3
8
|
[中文](#中文) · [English](#english)
|
|
4
9
|
|
|
5
10
|
`file-brief` is an agent-agnostic skill (OpenAI Codex · Claude Code · DeepSeek Harness) that turns repeated input-file inspection into reusable, task-local documentation.
|
|
@@ -63,6 +68,16 @@ Copy-Item -LiteralPath ".\skills\file-brief" -Destination "$HOME\.dsh\skills\fil
|
|
|
63
68
|
mkdir -p ~/.claude/skills && cp -R skills/file-brief ~/.claude/skills/
|
|
64
69
|
```
|
|
65
70
|
|
|
71
|
+
**npm 安装(DeepSeek Harness 插件方式)**:`file-brief@2.0.0` 已发布到 npm(声明 `dsh.bundle`),可以作为 DSH 插件安装,也可在 [deepseek1024.com](https://deepseek1024.com/) 插件商店详情页获得一键安装命令:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
dsh plugin --profile web add file-brief
|
|
75
|
+
# 或
|
|
76
|
+
npx @deepseek-ai/dsh plugin --profile web add file-brief
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
> 说明:作为 npm 插件安装时,bundle 的 patch 层是空操作(技能本体通过 SKILL.md 加载);仍建议把技能复制到 `~/.dsh/skills` 等技能根目录以获得最佳体验。
|
|
80
|
+
|
|
66
81
|
安装后请启动一个新的 Agent 会话,使技能列表重新加载。
|
|
67
82
|
|
|
68
83
|
### 为什么每个任务拥有自己的目录
|
|
@@ -363,6 +378,16 @@ Manual copy also works:
|
|
|
363
378
|
mkdir -p ~/.claude/skills && cp -R skills/file-brief ~/.claude/skills/
|
|
364
379
|
```
|
|
365
380
|
|
|
381
|
+
**Install from npm (DeepSeek Harness plugin style)**: `file-brief@2.0.0` is published to npm with a `dsh.bundle` declaration, so it can be installed as a DSH plugin, and the [deepseek1024.com](https://deepseek1024.com/) store shows a one-click install command on its plugin page:
|
|
382
|
+
|
|
383
|
+
```bash
|
|
384
|
+
dsh plugin --profile web add file-brief
|
|
385
|
+
# or
|
|
386
|
+
npx @deepseek-ai/dsh plugin --profile web add file-brief
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
> Note: installed as an npm plugin, the bundle's patch layer is a no-op (the skill itself loads through SKILL.md); copying the skill into `~/.dsh/skills` or another skill root still gives the best experience.
|
|
390
|
+
|
|
366
391
|
Start a new agent session after installation so the skill list reloads.
|
|
367
392
|
|
|
368
393
|
### Why catalogs are task-local
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "file-brief",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.1",
|
|
4
4
|
"description": "Agent-agnostic skill that turns task input files into reusable structural briefs and a per-task searchable index (OpenAI Codex, Claude Code, DeepSeek Harness)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
interface:
|
|
2
|
-
display_name: "Catalog Input Files"
|
|
3
|
-
short_description: "Catalog task files into reusable structural explanations"
|
|
4
|
-
default_prompt: "Use $file-brief to catalog this task folder before analyzing its input files."
|
|
5
|
-
|
|
6
|
-
policy:
|
|
7
|
-
allow_implicit_invocation: true
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Catalog Input Files"
|
|
3
|
+
short_description: "Catalog task files into reusable structural explanations"
|
|
4
|
+
default_prompt: "Use $file-brief to catalog this task folder before analyzing its input files."
|
|
5
|
+
|
|
6
|
+
policy:
|
|
7
|
+
allow_implicit_invocation: true
|