Awesome-omni-skill _context-ack

在每次回复中使用固定前缀并列出本次实际参考的指令/文件,便于校验是否遵循上下文与规则。

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/_context-ack" ~/.claude/skills/diegosouzapw-awesome-omni-skill-context-ack && rm -rf "$T"
manifest: skills/tools/_context-ack/SKILL.md
source content

_context-ack

目标

让用户能快速确认我是否实际引用/遵循了本次会话中的指令与文件。

必须遵循的输出约定

1) 固定前缀(每次回复首行)

  • 统一以
    ✨ 已启用上下文校验
    开头。
  • 该前缀用于让用户判断此技能是否生效。

2) 敬语称呼(单独一行)

  • 在首行之后,新增单独一行敬语称呼,例如:
    • 尊敬的主人:
  • 敬语行必须独立成行,避免与正文混排。

3) 引用清单(每次回复末尾)

在回复末尾追加两行:

已读指令:<指令文件及其核心要求>
已启用技能:<技能名与简要功能>

清单规则:

  • 只列出本次真实读取或实际依赖的指令/技能
  • 已读指令行:列出读取过的指令文件名及其对应的核心要求或应用部分
  • 已启用技能行:列出使用的技能名与其在本次回复中的实际贡献一行一个技能,格式为:
    • 已启用技能:技能名 - 技能说明
  • 若本次未引用任何文件或技能,必须写:
    • 已读指令:无
    • 已启用技能:无

3.1) 引用校验清单(强制)

  • 已读指令必须来自本次显式读取(如
    read_file
    )。
  • 禁止填写“未实际读取但猜测存在”的文件。
  • 如未读取任何指令文件,必须写
    已读指令:无

3.2) 技能使用证据收集(可选增强)

为了增强透明度和可追踪性,当列出某个已启用技能时,应在回复正文中体现该技能的实际使用证据:

技能名使用证据验证方式
_git-commit
提交说明文件末尾有签名行搜索 "🤖 本提交由 _git-commit"
_file-output-guard
文件中包含
[Part X/?]
分段标记
查看文件内容的分段标记
_change-summary
PR 描述中有 "提交摘要" 段落(来自
git log --oneline
检查 PR 或 PR_DESCRIPTION.local.md
_traceability-check
提交说明覆盖了
git diff --name-only --cached
列出的所有文件
对照检查清单
_code-health-check
回复中提及测试通过、编译成功等验证结果查看回复内容或控制台输出
_instruction-guard
本次回复的 "已读指令" 列出了被读取的指令文件见"已读指令"行

最佳实践

  • 列出技能时,在回复正文中至少提及该技能的一条关键步骤或输出
  • 例如:列出
    _git-commit - 格式化提交说明
    时,回复中应提及 "已使用 Conventional Commits 格式" 或 "已添加签名行"
  • 这样用户可快速验证技能是否真的被执行,而不仅仅是被列在清单中

4) 仓库信息提示(每次回复末尾,位于"已启用技能"下一行)

追加一行:

仓库状态:分支=<branch> | 未提交=<count_uncommitted> | 未跟踪=<count_untracked>

填写规则:

  • 分支:
    git rev-parse --abbrev-ref HEAD
  • 未提交:
    git status --porcelain
    中已跟踪且变更的条目数
  • 未跟踪:
    git status --porcelain
    中以
    ??
    开头的条目数

5) 输出样式(diff 代码框格式)

将会话结尾信息放在 diff 格式代码框中,利用语法高亮区分不同类型信息:

─────────────────────────────────────────────
+ ✅ 已读指令:[文件名]
- 🔧 已启用技能:技能名 A - 技能说明
- 🔧 已启用技能:技能名 B - 技能说明
! 📦 仓库状态:分支=<branch>
!   └─ 未提交:<n> (仅当>0时显示)
!   └─ 未跟踪:<m> (仅当>0时显示)
─────────────────────────────────────────────

格式说明

  • 使用 diff 语法高亮,每种信息有不同颜色:
    • +
      绿色:已读指令
    • -
      红色:已启用技能
    • !
      橙色:仓库状态
  • 使用
    └─
    树形结构展示细节
  • 使用更细的分隔线
    (U+2500)
  • 仓库状态的未提交/未跟踪数字为 0 时不显示该行
  • 如果两者都为 0,仅显示分支信息

适用范围

  • 所有对话所有回复
  • 若用户指定"本次不要前缀/清单",才可临时忽略。

注意事项

  • 不要虚构引用。
  • 不要列出仅"已在上下文但未使用"的文件。
  • 保持简洁,清单只列实际使用项。