weekly-report-hy 1.0.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.
package/README.md ADDED
@@ -0,0 +1,96 @@
1
+ # 📦 weekly-report-hy
2
+
3
+ > 周报生成工具 — 将零散的工作记录整理为格式规范、表述专业的中文周报
4
+
5
+ [![npm version](https://img.shields.io/npm/v/weekly-report-hy.svg)](https://www.npmjs.com/package/weekly-report-hy)
6
+ [![License](https://img.shields.io/npm/l/weekly-report-hy.svg)](https://github.com/cryptocxf/weekly-report-hy/blob/main/LICENSE)
7
+
8
+ ## 📋 功能简介
9
+
10
+ **weekly-report-hy** 是一个智能周报生成工具,接收用户提供的零散、口语化的中文工作记录,自动整理为格式规范、表述专业的工作周报。
11
+
12
+ ### 核心能力
13
+
14
+ | 功能 | 说明 |
15
+ |------|------|
16
+ | 🧠 **智能分类** | 自动按项目或主题对工作内容归类,生成 `【项目名】` 式分段结构 |
17
+ | ✍️ **专业化润色** | 将口语化描述转为专业工作表述,补全合理语境,丰富表达 |
18
+ | 📐 **格式标准化** | 统一的分段、编号、标点规范,开箱即用 |
19
+ | 🚫 **内容保真** | 基于原文事实润色,绝不编造未提及的内容 |
20
+
21
+ ---
22
+
23
+ ## 🚀 使用方式
24
+
25
+ 本工具作为 AI 技能(Skill)使用,配合支持 OpenClaw 协议的 AI 助手。
26
+
27
+ ### 快速使用
28
+
29
+ 在对话中提供你的本周工作记录,例如:
30
+
31
+ ```
32
+ 这周做了:
33
+ 1. 跟产品部对了下需求
34
+ 2. 写了个数据中台的方案初稿
35
+ 3. 看了下竞品 ABC 的功能
36
+ 4. 帮新人小李配了开发环境
37
+ 5. 开了两次部门周会
38
+ ```
39
+
40
+ AI 助手将自动调用 `weekly-report-hy` 技能,输出格式规范的周报。
41
+
42
+ ---
43
+
44
+ ## 📖 输出示例
45
+
46
+ **输入:**
47
+ ```
48
+ XX 平台每日运行数据处理;支撑业务部门同事进行平台账号开通;配合外部领导完成产品线上演示;撰写行业标准草案修改意见。
49
+ ```
50
+
51
+ **输出:**
52
+ ```
53
+ 【XX 平台】
54
+ 1. 完成 XX 平台每日运行数据的拉取、清洗与汇总分析,持续保障数据日报的准确性与时效性;
55
+ 2. 支撑业务部门同事完成 XX 平台的账号开通、配置与基础功能使用;
56
+ 3. 配合外部领导调研需要,完成 XX 平台的线上演示与功能讲解。
57
+
58
+ 【科研项目】
59
+ 1. 围绕行业标准草案开展深入研读与对标分析,撰写并提交本轮修改意见。
60
+ ```
61
+
62
+ ---
63
+
64
+ ## 📁 项目结构
65
+
66
+ ```
67
+ weekly-report-hy/
68
+ ├── SKILL.md # 完整技能文档(核心)
69
+ ├── README.md # 本文件
70
+ ├── package.json # npm 包信息
71
+ └── skill-card.md # 技能审核卡片
72
+ ```
73
+
74
+ ---
75
+
76
+ ## 🔒 安全说明
77
+
78
+ - 本工具不收集或上传任何数据
79
+ - 所有处理在 AI 对话上下文中完成
80
+ - 工作内容中的敏感信息会根据用户要求保留或脱敏
81
+
82
+ ---
83
+
84
+ ## 📝 版本历史
85
+
86
+ - **v1.0.0** — 初始版本发布到 npm
87
+
88
+ ---
89
+
90
+ ## 👤 作者
91
+
92
+ [cryptocxf](https://clawhub.ai/user/cryptocxf)
93
+
94
+ ## 📄 许可证
95
+
96
+ MIT License
package/SKILL.md ADDED
@@ -0,0 +1,169 @@
1
+ ---
2
+ name: weekly-report-hy
3
+ description: 根据用户提供的本周工作内容,生成格式标准、内容饱满丰富、语言专业的中文周报。当用户提到"周报"、"周总结"、"工作汇报"、"本周工作"、"整理成周报"等关键词,或者把本周做的事情罗列出来希望整理成正式格式时,务必使用此技能。该技能会智能识别并将工作内容按项目或主题分类,使用【】格式作为大标题,大标题下用阿拉伯数字编号列出具体工作事项,并对原始描述进行专业化润色,使其逻辑清晰、表达饱满、句式通顺。
4
+ ---
5
+
6
+ # 周报生成技能
7
+
8
+ ## 目标
9
+
10
+ 将用户提供的零散、简略、口语化的工作记录,整理成一份格式规范、表述专业、内容饱满的本周工作汇报。重点在于:**重组结构** + **润色语言** + **丰富表达**,但不得编造事实。
11
+
12
+ ## 输出格式
13
+
14
+ 严格按以下格式输出,不得偏离:
15
+
16
+ ```
17
+ 【类别一】
18
+ 1. 第一项工作描述;
19
+ 2. 第二项工作描述;
20
+ 3. 第三项工作描述。
21
+
22
+ 【类别二】
23
+ 1. 第一项工作描述;
24
+ 2. 第二项工作描述。
25
+
26
+ 【其他】
27
+ 1. 杂项工作1;
28
+ 2. 杂项工作2。
29
+ ```
30
+
31
+ 格式细节:
32
+ - 大类标题使用全角中文方括号 `【】` 包裹,独占一行,标题本身不带编号
33
+ - 子项使用阿拉伯数字 + 半角点 + 空格开头(如 `1. `、`2. `)
34
+ - 每条子项以中文分号 `;` 结尾;每个大类的最后一条以中文句号 `。` 结尾
35
+ - 大类之间空一行分隔
36
+
37
+ ## 工作流程
38
+
39
+ ### 第一步:仔细阅读用户的原始内容
40
+
41
+ 逐条读取用户提供的工作记录,识别其中涉及的:项目名称、任务性质、参与对象、产出物。注意原始描述可能简略、口语化、句式不通顺,需要做加工但不能臆造。
42
+
43
+ ### 第二步:智能划分大类
44
+
45
+ 依据以下原则归类:
46
+
47
+ 1. **以项目为单位划分**:同一个项目相关的多项工作合并为一类,标题取项目名称,例如 `【XX 平台】`、`【XX 系统】`、`【XX 智能体】`。
48
+ 2. **以主题为单位划分**:不属于具体项目但属同一工作主题的归为一类,标题取主题名,例如 `【科创相关】`、`【xx算法】`、`【对外交流】`、`【调研学习】`、`【部门管理】`。
49
+ 3. **【其他】兜底**:零散的、不属于以上任何一类的事项放入 `【其他】`,该类别始终放在最后。
50
+ 4. **类别数量控制**:一般 3~5 个大类最佳;过少结构不清晰,过多则显琐碎。
51
+ 5. **类别排序**:按重要性或工作量从高到低排列;`【其他】` 始终最后。
52
+ 6. **避免单条独占大类**:除非该项工作本身分量足够,否则尽量与其他相近主题合并;若实在没有同类项,可放入 `【其他】`。
53
+
54
+ ### 第三步:逐条润色与丰富
55
+
56
+ 用户原始描述往往简略或不通顺,需要专业化加工。**核心原则:基于原文事实润色,绝不编造未提及的项目、人物、数据、产出物。**
57
+
58
+ 润色思路:
59
+
60
+ 1. **替换为更专业的动词**:把笼统动词换成更具体的工作动词。例如:
61
+ - "做" → "推进 / 落实 / 完成 / 牵头"
62
+ - "看" → "调研 / 梳理 / 研读 / 分析"
63
+ - "写" → "撰写 / 起草 / 编制 / 输出"
64
+ - "聊" → "沟通 / 协商 / 对接 / 研讨"
65
+ - "帮" → "支撑 / 配合 / 协助"
66
+
67
+ 2. **补足合理语境**:如果原描述只有动作和对象,可补充范围、目的、产出等可由上下文合理推得的语境。例如:
68
+ - 原文:"支撑领导演示" → 润色后:"支撑相关领导完成产品的现场演示工作,重点讲解核心功能与应用成效"
69
+ - 原文:"调研 X 技术" → 润色后:"对 X 技术开展专题调研,系统梳理其核心特性、适用场景及可借鉴之处,形成调研报告"
70
+
71
+ 3. **修正句式**:将不通顺的短语改写为完整、通顺的工作语句,确保主谓宾完整。
72
+
73
+ 4. **结构化表达**:对包含多个动作的事项,采用"动作 1 + 动作 2 + 产出物"的结构,使工作量与成果一目了然。例如:
74
+ - "讨论需求,写需求表" → "与安全团队多轮研讨技术路线与攻关方向,共同撰写并完善攻关需求表,推动项目立项材料定稿"
75
+
76
+ 5. **避免空话套话**:不要堆砌"积极""认真""高度重视""扎实推进"这类无信息量的形容词。聚焦于"做了什么""产出了什么""推进到什么程度"。
77
+
78
+ 6. **数量适中**:每条润色后建议在 25~60 字之间。过短显得单薄;过长则可能空洞或失真。
79
+
80
+ ### 第四步:输出前自检
81
+
82
+ 发布前逐项核对:
83
+ - 格式是否完全符合规范(`【】`、序号、`;`/`。`、空行)
84
+ - 每个大类下是否至少有 1 条
85
+ - 每条是否为完整通顺的工作语句
86
+ - 用户提到的所有原始事项是否都被覆盖,无遗漏、无合并丢失
87
+ - 是否引入了原文没有的事实(若有则删除)
88
+ - 全文语气、句式是否统一
89
+
90
+ ## 示例
91
+
92
+ ### 示例 1:典型场景
93
+
94
+ **用户原始输入:**
95
+
96
+ ```
97
+ 1. XX 平台每日运行数据处理;
98
+ 2. 支撑业务部门同事进行平台账号开通及基础使用;
99
+ 3. 配合外部领导完成产品线上演示;
100
+ 4. 撰写行业标准草案修改意见;
101
+ 5. 与xx团队讨论协商,撰写课题项目申报材料;
102
+ 6. 与外部厂商交流,沟通产品适配、合作方案等内容;
103
+ 7. 对某新型技术进行调研,输出调研报告;
104
+ 8. 修改产品汇报材料 ppt。
105
+ ```
106
+
107
+ **生成的周报:**
108
+
109
+ ```
110
+ 【XX 平台】
111
+ 1. 完成 XX 平台每日运行数据的拉取、清洗与汇总分析,持续保障数据日报的准确性与时效性;
112
+ 2. 支撑业务部门同事完成 XX 平台的账号开通、配置与基础功能使用,协助解决使用过程中遇到的问题;
113
+ 3. 配合外部领导调研需要,完成 XX 平台的线上演示与功能讲解,重点展示核心应用场景与运营成效。
114
+
115
+ 【科研项目】
116
+ 1. 围绕行业标准草案开展深入研读与对标分析,撰写并提交本轮修改意见,形成完整的反馈意见文档;
117
+ 2. 与安全团队多轮讨论协商,梳理项目技术路线与攻关方向,共同撰写并完善课题项目申报材料,推进立项工作。
118
+
119
+ 【对外交流】
120
+ 1. 与外部厂商技术团队开展专项交流,围绕产品适配、合作模式等关键事项进行深入沟通,初步明确后续对接路径。
121
+
122
+ 【其他】
123
+ 1. 对某新型技术开展专题调研,系统梳理其核心特性、应用场景与可借鉴之处,完成并输出调研报告;
124
+ 2. 根据最新汇报口径,对产品汇报材料 PPT 进行修改完善,优化整体内容结构与表达逻辑。
125
+ ```
126
+
127
+ ### 示例 2:输入更口语化的情况
128
+
129
+ **用户原始输入:**
130
+
131
+ ```
132
+ 这周做的事:
133
+ 跟产品部对了下需求
134
+ 写了个数据中台的方案初稿
135
+ 看了下竞品 ABC 的功能
136
+ 帮新人小李配了开发环境
137
+ 开了两次部门周会
138
+ ```
139
+
140
+ **生成的周报:**
141
+
142
+ ```
143
+ 【数据中台】
144
+ 1. 与产品部就新一期需求开展专项对接,明确功能边界、优先级与交付节奏;
145
+ 2. 完成数据中台整体方案初稿撰写,涵盖架构设计、模块划分与关键技术选型。
146
+
147
+ 【调研与协作】
148
+ 1. 对竞品 ABC 的核心功能进行调研分析,梳理其差异化亮点,形成对比参考材料;
149
+ 2. 协助新入职同事完成本地开发环境搭建与基础工具配置,帮助其快速进入工作状态。
150
+
151
+ 【其他】
152
+ 1. 参加部门周例会两次,同步本周工作进展并对齐下周重点任务。
153
+ ```
154
+
155
+ ## 关键原则
156
+
157
+ 1. **不编造**:绝不臆造用户未提及的项目、人物、数据、产出物、时间节点。
158
+ 2. **不遗漏**:用户提到的每一项工作都要在输出中体现,不可丢失。
159
+ 3. **不喧宾夺主**:润色服务于事实呈现,而非用华丽辞藻覆盖真实工作。
160
+ 4. **风格统一**:整篇周报语气、句式、动词选择保持一致。
161
+ 5. **直接输出**:无需冗长前言,直接给出整理好的周报正文。如确有必要的说明(例如某项内容信息不足、需要用户补充),放在周报后简短附注即可。
162
+
163
+ ## 处理边界情况
164
+
165
+ - **用户内容极少(只有 1~2 条)**:不要硬凑分类。可以只用 1~2 个大类,甚至全放在一个大类下。
166
+ - **用户内容很多(15 条以上)**:适当增加大类数量(可到 5~6 个),并合并相似事项,避免出现两条几乎重复的子项。
167
+ - **用户内容含敏感信息(如具体客户名、金额等)**:照实保留,不替换、不脱敏,除非用户另行要求。
168
+ - **用户内容已经写得很好**:仍按本技能要求重新组织格式,但润色幅度可减小,避免过度改写造成失真。
169
+ - **用户在原始内容中已自带分类**:尊重用户的分类意图;只在分类明显不合理(例如把同一项目拆到多个类别)时才重新归类,且应在输出后简短说明调整原因。
package/package.json ADDED
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "weekly-report-hy",
3
+ "version": "1.0.0",
4
+ "description": "周报生成工具 - 将零散的工作记录整理为格式规范、表述专业的中文周报。支持智能分类、专业化润色、多场景适配。",
5
+ "main": "SKILL.md",
6
+ "scripts": {
7
+ "start": "echo 'See SKILL.md for usage instructions'"
8
+ },
9
+ "keywords": [
10
+ "weekly-report",
11
+ "report",
12
+ "chinese",
13
+ "work-report",
14
+ "周报",
15
+ "周总结",
16
+ "工作汇报",
17
+ "weekly-summary"
18
+ ],
19
+ "author": "cryptocxf",
20
+ "license": "MIT",
21
+ "repository": {
22
+ "type": "git",
23
+ "url": "git+https://github.com/cryptocxf/weekly-report-hy.git"
24
+ },
25
+ "homepage": "https://clawhub.ai/cryptocxf/weekly-report-hy",
26
+ "bugs": {
27
+ "url": "https://github.com/cryptocxf/weekly-report-hy/issues"
28
+ },
29
+ "engines": {
30
+ "node": ">=10.0.0"
31
+ },
32
+ "os": ["win32", "darwin", "linux"],
33
+ "files": [
34
+ "SKILL.md",
35
+ "README.md",
36
+ "skill-card.md"
37
+ ]
38
+ }
package/skill-card.md ADDED
@@ -0,0 +1,40 @@
1
+ ## Description: <br>
2
+ Weekly Report Hy formats user-provided Chinese work notes into a structured, professionally worded weekly report without adding unsupported facts. <br>
3
+
4
+ This skill is ready for commercial/non-commercial use. <br>
5
+
6
+ ## Publisher: <br>
7
+ [cryptocxf](https://clawhub.ai/user/cryptocxf) <br>
8
+
9
+ ### License/Terms of Use: <br>
10
+ MIT-0 <br>
11
+
12
+
13
+ ## Use Case: <br>
14
+ Employees and teams use this skill to turn brief Chinese weekly work notes into categorized, polished weekly reports for status updates or internal reporting. <br>
15
+
16
+ ### Deployment Geography for Use: <br>
17
+ Global <br>
18
+
19
+ ## Known Risks and Mitigations: <br>
20
+ Risk: User notes may contain client names, internal project details, amounts, or other confidential information. <br>
21
+ Mitigation: Review pasted notes before use and ask the agent to redact or generalize sensitive details when the report may be shared. <br>
22
+ Risk: Professional rewriting can make vague source notes sound more certain than the underlying facts support. <br>
23
+ Mitigation: Compare the generated report against the original notes and remove any detail that was not supplied or reasonably grounded. <br>
24
+
25
+
26
+ ## Reference(s): <br>
27
+ - [ClawHub skill page](https://clawhub.ai/cryptocxf/weekly-report-hy) <br>
28
+
29
+
30
+ ## Skill Output: <br>
31
+ **Output Type(s):** [text, markdown, guidance] <br>
32
+ **Output Format:** [Structured Chinese Markdown-style text with bracketed section headings and numbered items] <br>
33
+ **Output Parameters:** [1D] <br>
34
+ **Other Properties Related to Output:** [Groups items by project or topic, keeps miscellaneous work last, and preserves user-provided facts without unsupported additions.] <br>
35
+
36
+ ## Skill Version(s): <br>
37
+ 1.0.0 (source: server release metadata) <br>
38
+
39
+ ## Ethical Considerations: <br>
40
+ Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>