给想读懂并长期维护自己项目的人。让 agent 动手前先判断，改代码先画影响面，交付时指出哪段值得你完全理解。
16 个 skill，按类目或单个自选，装到 Claude Code、Codex、OpenCode、Pi、Hermes Agent、DeepSeek Harness。
| 目录 | 用途 |
|---|---|
skills/ |
核心 Skill 规则，按类目组织 |
scripts/ |
仓库校验工具；安装使用根目录的 install.ps1 / install.sh |
herdr/ |
Herdr 配置指南与配套脚本，按目录说明安装和使用 |
1. Claude Code
/plugin marketplace add RedGranite/smartskill
/plugin install coding@smartskill # 或 thinking@smartskill、search@smartskill
2. Codex
npx skills add RedGranite/smartskill -a codex -g # 全部
npx skills add RedGranite/smartskill -a codex -g -s before-build # 单个3. 其他遵循 Agent Skills 标准的 CLI（OpenCode、Pi、Hermes Agent、DeepSeek Harness 等）
npx skills add RedGranite/smartskill -a opencode -g # -a 可选 opencode / pi / hermes / universaluniversal 装到 ~/.agents/skills，DeepSeek Harness 读这个目录。无 Node 时用仓库脚本：
./install.ps1 -Component coding -Agent dsh,hermes # Windows
./install.sh --component coding --agent dsh,hermes # macOS / Linux仓库脚本先暂存新版本，再备份并替换已有 Skill；复制失败保留原安装，替换失败尝试恢复旧版。备份包含本地修改，保存在目标 skills 的同级 smartskill-backups 目录，脚本打印具体路径，确认不再需要后自行删除。每个 Skill 单独更新，后续失败不会撤销前面已完成的更新；中断后可从备份恢复。
去掉 -g 装到当前项目的 .agents/skills。更新即重跑。
贴进 CLAUDE.md / AGENTS.md / DSH.md / SOUL.md，让实现前关卡生效：
- 进入实现阶段（脚手架、demo、首次写代码）前，先执行 skill `before-build`，在回复里产出判断记录并经我确认。
| 类目 | skill | 用途 |
|---|---|---|
| coding | before-build | 实现前关卡：八维度判断记录，确认后动手 |
change-safely | 改已有代码：先说影响面，不顺手重构，按步 commit，附验收命令 | |
debug-root-cause | 先复现再定位，修根因，加回归检查 | |
build-vs-buy | 先查 SDK / 库 / 成品，压缩自研范围 | |
ssot-reuse | 一处定义，主动抽象，接口优先 | |
concurrency-modeling | 并发与竞态：状态机 / 幂等键 / event-driven | |
engineering-review | 异常路径、状态一致性、可观测性、tech debt | |
spec-first | 按需取六节的 spec：目标 / 非目标 / 接口 / 状态 / critical path / 验证 | |
guardrails | lint / 类型 / CI / e2e 把规则确定化 | |
minimal-viable | MVP 推进，验证只做一次 | |
powershell-utf8 | Windows 编码问题排查 | |
| thinking | doc-writing | 文档写作标准 |
decision-analysis | 有标准、有证据的方案取舍 | |
plain-language | 中文表达，去 AI 味 | |
context-legibility | 长程任务：每轮可独立读懂，不输出无效结论 | |
| search | search-sources | 第三方搜索源目录与分流，见下节 |
简单问题（单一事实、一两次查询可答）用 CLI 自带搜索；复杂问题（多源交叉、全文抓取、学术 / 代码文档 / 社媒 / 中文专库）才用下表的第三方源。目录只收第三方，不写检索逻辑。agent 按「领域匹配 > 结果格式 > 已安装 > 价格低」选源；用户点名则直接用；未安装时给出安装命令，不自行安装；结论性事实至少两源，矛盾时并列不裁决。Pi 不支持 MCP，只能用标「两者」的源。
| 源 | 类型 | 擅长 | 免费额度 | 安装 |
|---|---|---|---|---|
| SearXNG | MCP | 通用网页 / 新闻 | 自托管永久免费，无 key | npx -y mcp-searxng |
| Tavily | MCP | 通用网页 / 新闻 | 1,000 credits/月 | npx -y tavily-mcp@latest |
| Brave Search | MCP | 通用网页 / 新闻 | $5 credits/月 | npx -y @brave/brave-search-mcp-server |
| Exa | 两者 | 通用网页 / 学术 | $20 注册 + $10/月 | npx -y exa-mcp-server |
| Firecrawl | MCP | 抓取 / 代码文档 | 1,000 credits/月 | npx -y firecrawl-mcp |
| Jina Reader | MCP | 正文抽取 / 学术 | 新 key 1,000 万 tokens | 远程 https://mcp.jina.ai/v1 |
| Perplexity Sonar | MCP | 新闻 / 通用网页 | 无 | npx -y @perplexity-ai/mcp-server |
| mcp-news | MCP | 新闻（GDELT / RSS / HN） | 永久免费，无 key | cargo install mcp-news |
| arXiv | 两者 | 学术 | 永久免费，无 key | uvx arxiv-mcp-server |
| AIRA-SemanticScholar | MCP | 学术 | 永久免费 | npx -y aira-semanticscholar |
| Context7 | 两者 | 代码文档（按版本） | 1,000 次/月 | npx -y @upstash/context7-mcp |
| hn-mcp-server | MCP | Hacker News | 永久免费，无 key | npx -y @cyanheads/hn-mcp-server |
| Reddit MCP Buddy | MCP | 免费 100 QPM，搜索需凭据 | npx -y reddit-mcp-buddy |
|
| 秘塔 Metaso | MCP | 中文 / 学术 | 5,000 点（一次性） | npx metaso-search-mcp |
| 博查 Bocha | MCP | 中文 | 1,000 次（一次性，仓库停更） | 需 clone，见 catalog |
价格、key 变量名、各 CLI 的 MCP 接入语法见 skills/search/search-sources/references/。X / Twitter 无免费方案，未收录。
Claude Code、Codex、DeepSeek Harness 已实测（2026-08-28）；OpenCode、Pi、Hermes Agent 按其官方 skill 目录写入，未实测。
MIT