📝 docs(skills): add anthropics document-skills integration

This commit is contained in:
csh 2025-12-17 14:49:18 +08:00
parent cf9f80da80
commit c0895dd02c
1 changed files with 36 additions and 5 deletions

View File

@ -173,17 +173,49 @@ description: Structured code review for TSL/C++/Python diffs & PRs. Triggers: co
--- ---
## 5. 推荐外部技能(直接复用) ## 5. 官方文档技能pdf/docx/pptx/xlsx
Anthropic 官方仓库 `anthropics/skills` 提供了 `pdf`/`docx`/`pptx`/`xlsx` 四个文档技能,并以插件 **document-skills** 的形式分发。
### 5.1 安装Claude Code
在 Claude Code 中执行:
- `/plugin marketplace add anthropics/skills`
- `/plugin install document-skills@anthropic-agent-skills`
### 5.2 使用约束(重要)
这些技能目录包含 `LICENSE.txt`,属于 **Proprietary** 材料;按其条款通常 **不允许** 你把目录内容复制到自己的仓库里做二次分发/改造。推荐做法是:只通过 Claude Code 的 plugin 系统安装与使用。
### 5.3 在你自己的 Skill 里“调用它们”(推荐模板)
把下面片段加入你的 `SKILL.md`(作为“依赖/分发规则”即可):
```markdown
## Document Skills Dependency (optional)
If available in this environment, prefer Anthropic document-skills:
- `pdf` for PDF extraction/forms/merge/split
- `docx` for Word creation/editing/redlining (tracked changes/comments)
- `pptx` for PowerPoint generation/editing/thumbnail validation
- `xlsx` for Excel editing with formulas + recalc + zero-error checks
If these skills are not installed/available, ask whether to proceed with an open-source fallback workflow.
```
---
## 6. 推荐外部技能(直接复用)
来自仓库https://github.com/YYH211/Claude-meta-skill 来自仓库https://github.com/YYH211/Claude-meta-skill
### 5.1 建议引入的 3 个通用技能 ### 6.1 建议引入的 3 个通用技能
- `create-skill-file`skill 编写规范 + 模板(适合团队内部统一口径) - `create-skill-file`skill 编写规范 + 模板(适合团队内部统一口径)
- `prompt-optimize`:提示词架构/对话式优化(适合为内部 agent 设计 system prompt - `prompt-optimize`:提示词架构/对话式优化(适合为内部 agent 设计 system prompt
- `deep-reading-analyst`:深度阅读/多框架分析(适合评审 RFC/ADR/设计文档/长文资料) - `deep-reading-analyst`:深度阅读/多框架分析(适合评审 RFC/ADR/设计文档/长文资料)
### 5.2 安装命令(项目内) ### 6.2 安装命令(项目内)
```bash ```bash
git clone https://github.com/YYH211/Claude-meta-skill.git git clone https://github.com/YYH211/Claude-meta-skill.git
@ -196,9 +228,8 @@ cp -r Claude-meta-skill/deep-reading-analyst .claude/skills/
--- ---
## 6. 运行时排障(面向专家) ## 7. 运行时排障(面向专家)
- 不触发:把真实触发词写进 `description`(贴近你们团队的说法;中英文同义词覆盖) - 不触发:把真实触发词写进 `description`(贴近你们团队的说法;中英文同义词覆盖)
- 触发错:减少关键词重叠;用更具体的上下文词(语言/工具/目录名/流程名) - 触发错:减少关键词重叠;用更具体的上下文词(语言/工具/目录名/流程名)
- 执行漂移:收紧 Output Contract将高风险步骤改为“默认停下确认”把细节拆到 `references/` 并按决策树显式加载 - 执行漂移:收紧 Output Contract将高风险步骤改为“默认停下确认”把细节拆到 `references/` 并按决策树显式加载