@xjq11029/guide-skills

把「代码分析 / 代码审查」方法论指南打包成独立的 SKILL.md 技能包，可移植、零运行时依赖，能被任意支持 SKILL.md 的加载器消费（包括 deepseek-harness 的 skill-filesystem）。

与 @xjq11029/dsh-guide-code-review（旧版 dsh Cordis 插件）的区别：本包不是 Cordis 插件，不含任何 @deepseek-ai/* 运行时依赖。它只发布 skills/ 目录下的 SKILL.md 内容 + 零依赖的维护脚本。你不需要 dsh 运行时即可消费这些技能；dsh 用户则通过目录扫描（见下文）加载，无需挂载任何插件。

包含的技能

| skill | 来源 | 触发时机 | | --- | --- | --- | | code-analysis-guide | guides/CODE_ANALYSIS_GUIDE.md | 需要理解/分析某项目或文件的实现、生成分析文档时 | | code-review-guide | guides/CODE_REVIEW_GUIDE.md | 需要审查 diff/变更集、出具审查意见与合入结论时 |

guides/_GUIDE_CHANGELOG.md 是变更日志（伴随文档，不是 skill）。

code-review-guide 的可选前置：它会产出/消费 docs/code-analysis/_PROJECT_PROFILE.md，该文件由 code-analysis-guide 在分析阶段生成。未做分析时也可直接审查，但引用项目上下文会更准。

安装

npm install @xjq11029/guide-skills

消费方式（非插件）

技能由 skill-filesystem 从目录扫描 SKILL.md。两种方式任选其一：

方式 A：环境变量零配置（bundled 源，rank 600）

DSH_BUNDLED_SKILL_DIR=node_modules/@xjq11029/guide-skills/skills \
  dsh --profile headless "审查这段改动"

方式 B：cordis.yml 高优先级挂载（custom 源，rank 300）

在 cordis.yml 的 skill-filesystem 条目加 customSkillDirs：

- id: skills
  name: '@deepseek-ai/dsh-skill-filesystem'
  config:
    customSkillDirs:
      - 'node_modules/@xjq11029/guide-skills/skills'

加载后，dsh 会把 code-analysis-guide / code-review-guide 作为普通技能识别，按 whenToUse 自动触发或经 user-invocable 手动调用。

单一可信源 & 构建

• 方法论只维护在 guides/*.md；包版本号即指南版本号。
• npm run build 从 guides/*.md 生成 skills/<id>/SKILL.md（frontmatter + 正文）。生成产物是构建输出，不进 git（prepublishOnly 会自动构建后发布）。
• npm run link-check 校验 guides/ 内部链接自洽（CI 闸门）。
• npm test 运行零依赖单测（linkCheck / buildSkills）。

维护者 CLI（可选）

bin/guide-skills.mjs 仅用于包维护（build / link-check），需要 dev 依赖 tsx（npm i）。普通消费者无需运行它——技能内容就在 skills/ 目录里。

发布

npm run build          # 生成 skills/
npm run link-check     # 校验链接
npm test               # 单测
npm publish --registry https://registry.npmjs.org/ --access public

发布前 prepublishOnly 会自动 build，确保 skills/ 是最新生成的内容。