Skill: ldxs001/skill-standardization (version 2.44.8)

--- name: skill-standardization version: 2.44.7 author: wUwproject license: MIT description: Skill 标准化规范引擎。支持 R-01~R-25 规范审查（audit/refactor/create 三模式），含权限扫描、数据目录合规检查、渐进式加载、更新日志渐进加载强制、_meta.json 字段规范性。R-07 增强：frontmatter trigger/trigger_negative 与正文一致性。 sensitive_access: false critical_write: false permission_weight: LOW data_dir: ../.standardization/skill-standardization/ tags: ['standardization', 'skill-builder', 'skill-audit', 'validation', 'json-loader', 'refactor', 'version-bump', 'changelog-auto', 'data-dir'] external_data_dir: true trigger: 当用户要求审计/创建/更新/改造一个 skill 时；当用户问 R-xx 规则含义时；当用户要求检查某技能规范性时 trigger_negative: 当用户仅闲聊或问你有什么技能时不触发；单步任务如查看文件不触发 meta_field_sync: true h1_position: true --- # skill-standardization ## 文件更新约束 > **本技能的所有 `.md` 文件禁止使用 Write/Edit 工具更新（会损坏 UTF-8 中文编码）。** > 必须用 `scripts/` 下的 Python 脚本原子写入（`tmp + os.replace()`）。 | 文件 | 更新方式 | 脚本 | |------|----------|------| | `SKILL.md` frontmatter | Python 原子写入 | `scripts/update_skill_frontmatter.py` | | `SKILL.md` 正文 | Python 直接重建 | `scripts/safe_io.py` 的 `safe_write()` | | `references/*.md` | `scripts/safe_io.py` 的 `safe_write()` | 随技能自带 | | 更新日志 | Python 合并脚本 | 每次发版统一维护 `references/changelog.md` | **版本号三端一致规则**（必须遵守）： - 版本号更新时必须同步更新以下 **3 处**，缺一不可： 1. `SKILL.md` frontmatter 的 `version:` 字段 2. `_meta.json` 的 `version` 字段 3. `references/changelog.md`（或 `CHANGELOG.md`）的版本条目 - `update --fix` 已自动执行上述三端同步（v2.38.10+） **检查清单（每次更新前）**： - [ ] 是否用了 Write/Edit 工具？→ 立刻停止，改用 Python 脚本 - [ ] 是否在 `references/changelog.md` 维护更新记录？→ 根目录不得有 `CHANGELOG.md` - [ ] 更新后是否用 `python -m scripts.skill_audit audit .` 自审？→ 必须 0 ERROR 0 WARN - [ ] `--fix` 自动修正后，是否将 fix_details 转化为可读 changelog 并用 safe_io 写入？→ 不得留机器名，禁止留空 > **注**：本技能的权限检查器（`permission_checker.py`）定义的敏感路径匹配模式（如 `~/.ssh/`、`~/.aws/` 等）仅用作**检测规则**，用于发现被审计 skill 是否违规访问这些路径；本技能本身不会实际访问这些敏感路径。 ## 触发场景 当用户提出以下类型请求时，应触发本技能： - [用 skill-standardization 审计/改造某技能] - [检查某技能的 SKILL.md 是否规范] - [创建/更新/重构一个 skill] - [skill 的 frontmatter 怎么写] - [R-xx 规则是什么意思] **不触发**（以下情况不应触发本技能）： - 用户只是问[你有什么技能]——这是闲聊，不是真的要审计/改造 - 用户要求执行某个 skill 的常规功能——应直接调用该 skill 本身，而不是先审计它 - 用户只是提到[skill]这个词，但没有明确的审计/创建/改造意图 ## 核心能力 > 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。 - **audit 模式** — 对指定 skill 目录执行 R-01~R-24 规范审查，输出通过/失败/跳过统计 - **refactor 模式** — 改造现有技能（修复 frontmatter、迁移更新记录、统一术语、规范数据目录、R-22 数据目录合规检查） - **create 模式** — 基于标准化模板创建新 skill，自动注入 R-07~R-09/R-18~R-22 章节引用 ## 工作流程 1. 读取目标 skill 的 SKILL.md 2. 执行 R-01~R-24 规则检查 3. 输出审查报告（通过/失败/跳过） 4. 若传了 --fix，自动修正 R-11/R-12/R-22 违规 5. **审计后自动修复（推荐）**：审计完成后，调用 `scripts/skill_audit/fix.py` 中的对应修复函数，批量修复 WARN/ERROR 项（详见 `references/guide.md` 审查模式章节） > **R-20 两阶段检查协议**（v2.38.2 新增）： > - 第一阶段（正则粗筛）： 执行正则匹配，输出所有疑似中英文混排间距问题 > - 第二阶段（LLM 精筛）：AI 对正则匹配结果逐条判断，过滤代码标识符误报（snake_case、camelCase、PascalCase、UPPER_CASE、文件名、路径），仅输出真实问题 > - 若 R-20 仍有误报，优先增强 预清理逻辑，其次放宽 LLM 过滤阈值 > **🛑 强制执行：排错止损规则（v2.38.5 新增，必须遵守）** > 1. **区分警告来源**：审计输出中的 WARNING/ERROR，先判断是审计工具自身触发的（如 `permission_checker.py` 的 `compile()` 触发 `SyntaxWarning`），还是被审计技能的真实问题。前者修审计工具，后者修被审计技能。不分清来源就动手 → 必然修错。 > 2. **同一操作失败 ≥2 次 → 强制停止换思路**： > - Grep 搜不到 → 检查是否把特殊字符当成正则元字符（如 `\Z` 在正则里是字符串结尾，搜字面 `\Z` 必须用 `grep -F` 或 Python `open().read()`） > - 工具调用报错 → 读完整 stderr，不要猜 > - 3 种不同思路都失败 → 向用户说明困境并请求指引，禁止继续重复 > 3. **用户提示止损**：当用户说又停了/死循环/你在干什么时，立即停止当前操作，向用户说明当前状态和下一步计划，禁止继续原操作。 > 4. **5 轮无实质进展 → 主动求助**：超过 5 轮对话还没有向前推进，必须向用户承认困境并请求指引。 ## 渐进式加载说明 本技能采用渐进式 MD 体系，SKILL.md 为轻量入口，详细规范拆分到 references/ 按需加载： - `references/guide.md` — 完整使用指南（触发词、工作流程、输出格式） - `references/architecture.md` — 内部架构（模块划分、RULES 注册、METHOD_MAP） - `references/antipatterns.md` — 反模式手册（常见错误 + 正确做法标记） - `references/faq.md` — 常见问题解答（排错、自定义规则、CI 集成） - `references/changelog.md` — 版本更新记录 > 阅读时先看本章节，按需让 AI 加载 references/*.md。 ## 临时文件与备份管理 > 本技能在创建、更新、改造过程中，对临时文件和备份文件进行全生命周期管理。 ### 管理规则 1. **操作前整体备份**：对目标技能目录执行整体备份（时间戳命名），记录在案，确保可回滚。 2. **操作中记录**：所有临时文件（`temp/`、`*.tmp`、脚本中间产物）和备份文件（`backup/`、`_bak_*` 目录）的产生路径、时间、操作类型均记录到 `op_logger` 日志。 3. **操作后清理**：主体创建/更新/改造完成（审计通过 + 版本号更新 + 更新日志维护完毕）后，按规范清除临时文件和过期备份。 4. **py 工具兜底能力**：`scripts/safe_io.py` 所有写操作（`safe_write`、`safe_patch_by_line`、`safe_patch_regex`、`safe_insert_after`）均内置 `backup_file()` 临时备份，返回 `rollback_id`，确保删/改动作可回滚。 ### 清理规范 | 文件类型 | 路径模式 | 保留时长 | 清理时机 | |-----------|-----------|----------|------------| | 临时文件 | `data/temp/*`、`*.tmp`、`draft_*` | 会话级（0天） | 每次操作完成后立即清除 | | 操作备份 | `data/backup/*` | 最近 10 个 | 每次操作完成后保留最新 10 个，其余清除 | | 整体备份 | `<skill-dir>_bak_*<timestamp>` | 操作完成确认后 | 操作完成并确认无异常后，提示用户是否清除 | | 日志文件 | `data/logs/ops.log` | 最近 200 条 | 超过 200 条时截断，保留最新 | ### 记录格式 每条临时/备份文件记录在 `op_logger` 日志中增加 `temp_files` 字段： ```json { ts: 2026-05-27T08:31:47, operation: refactor, file: ../.standardization/skill-standardization/, success: true, rollback_id: 20260527_083147_..., temp_files: [../.standardization/skill-standardization/data/temp/xxx.tmp], backup_files: [../.standardization/skill-standardization/data/backup/20260527_...bak], detail: ... } ``` > 本技能自身被更新时，同样遵守上述规则：更新前对 `../.standardization/skill-standardization/` 整体备份，操作中记录临时文件，更新完成后清理。 ## 数据目录说明 本技能的数据文件（审查缓存、进度文件、备份、日志等）存放在： ``` ../.standardization/skill-standardization/ ``` > 安装目录 `skills/skill-standardization/` 只保留 SKILL.md 和 scripts/，数据文件不越位。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: stale | SkillSpector: suspicious (CRITICAL)