一键在 Manus 中运行任何 Skill

doc-sentinel

星标6

分支1

更新时间2026年3月6日 10:11

Document-code change notification system: traceable doc-code binding via git tree hash, git-diff-driven reconciliation plans with confidence/risk metadata, and idempotent execution. Use when maintaining documentation freshness, detecting stale docs, or binding docs to source code.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

northseadl

northseadl/norix-skills

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Doc Sentinel — 文档-代码变更通知系统

核心概念

你负责守护一个仓库的文档健康度。三平面架构：

平面	目标	核心能力
Identity	绑定真值	文档 frontmatter 绑定 source paths + git tree hash
Reconciliation	变更推理	Git diff → ChangeEvent → Policy → ChangePlan (含 confidence/risk)
Capability	可选能力	索引生成（默认可用），矢量检索（未来独立技能）

核心价值：让 Agent 准确知道「哪些文档可能需要更新」，不承诺自动修复，不假装语义理解。

成功标准：

零漏报：代码变更必须被检测到
低误报：误报率 < 20%
可解释：每个通知附带变更证据和 confidence

工具

# 主入口
uv run <SKILLS_DIR>/doc-sentinel/scripts/sentinel.py <command> [options]

# --- 4 个核心命令 ---

# 1. 只读状态查询（无副作用）
status [--root <path>] [--doc <id>] [--source <path>] [--format json]

# 2. 建立/更新文档-代码绑定
bind <doc.md> [--source <path>...] [--auto-detect] [--root <path>]

# 3. 生成变更计划（不执行）
plan [--since <commit>] [--output plan.json] [--format json] [--root <path>]

# 4. 执行计划（幂等）
apply [--dry-run] [--root <path>]

工作流

Phase 1: 理解仓库

运行 status 查看文档健康状态
如无文档追踪，用 bind 为关键文档建立绑定

Phase 2: 绑定文档

为需要追踪的文档注入溯源 frontmatter：

# 显式指定源码路径
sentinel.py bind docs/auth.md --source "src/auth/" "src/middleware/auth.py"

# 自动检测（使用文档所在目录）
sentinel.py bind docs/api/overview.md --auto-detect

Phase 3: 检测变更

代码变更后，生成变更计划：

sentinel.py plan
# 输出：
#   📋 Stable actions (auto-executable):
#     📝 UPDATE → auth/overview
#        Reason: Source modified (42 lines): src/auth/handler.py
#   🔍 Review items (need confirmation):
#     ✨ CREATE → ?
#        Reason: New file in untracked area: src/billing/stripe.py

Phase 4: 执行计划

# 预览
sentinel.py apply --dry-run

# 执行（仅执行 STABLE 级别的操作）
sentinel.py apply

溯源 Frontmatter 规范

每份受管文档头部嵌入：

---
doc_id: "module/feature"
source_paths: ["module/src/"]
source_tree_hash: "a3f2b8c4d5e6"
last_sync_commit: "e7d1c4a..."
sync_timestamp: "2026-03-05T14:00:00+08:00"
doc_version: 3
status: "synced"
---

变更计划 (ChangePlan) 结构

每个 PlanItem 附带 Agent 可消费的元数据：

{
  "action": "update",
  "risk": "stable",
  "doc_id": "auth/overview",
  "reason": "Source modified (42 lines): src/auth/handler.py",
  "confidence": 0.84,
  "details": {
    "modified_source": "src/auth/handler.py",
    "lines_changed": 42
  }
}

动作分类:

分类	动作	语义
STABLE	UPDATE, RENAME, ARCHIVE	可自动执行，风险低
REVIEW	CREATE	需 Agent/人工确认

显著性阈值

修改 (M) 状态使用阈值过滤噪声（默认 5 行）。可通过环境变量调整：

DOC_SENTINEL_THRESHOLD=10 sentinel.py plan

数据目录

<repo_root>/.doc-sentinel/
├── registry.json          # 文档注册表（绑定关系）
├── last_sync_commit       # 上次同步 commit SHA
└── change_log.json        # 操作历史（保留最近 50 条）

参考文档

文档	用途	何时读取
decision-tree.md	变更操作决策树详解	处理 plan/apply 时
traceback-spec.md	溯源标识详细规范	维护 frontmatter 时

输出约定

思考/规划/报告: 中文
代码/命令/文件名: English
Frontmatter: YAML (English keys)

同仓库更多 Skills

同仓库

agent-brainstorm

northseadl/norix-skills

Multi-agent brainstorming: async opinion collision with expert personas. Mixed Codex/Claude Code engine. Use when multiple AI agents need to collaboratively discuss, debate, and converge on solutions through structured dialog. Triggers: brainstorm, multi-perspective discussion, opinion collision, expert debate, war room, collective intelligence, 头脑风暴, 多视角讨论, 集思广益.

2026-03-146

adb-mysql

northseadl/norix-skills

阿里云 AnalyticDB (ADB) for MySQL 只读数据分析。多维分析（计数/聚合/时间序列）、交叉验证、Schema 文档生成、多 Profile。

2026-03-146

es-analytics

northseadl/norix-skills

Elasticsearch / SLS 只读数据分析：索引探索、mapping、聚合统计、日志搜索、时间序列、多 Profile。

2026-03-146

image-studio

northseadl/norix-skills

AI image generation and editing: e-commerce templates (hero/banner/detail/lifestyle), image refinement (background replace/remove, enhance, retouch, style transfer), icon extraction (bg-removal + detect + smart crop with transparent output).

2026-03-146

feishu-integration

northseadl/norix-skills

Feishu (Lark) unified CLI for tasks, documents, wiki, bitable, messaging, approval, and Drive. Supports search/create/edit/publish/export across all modules. Use when reading/writing Feishu docs, searching docs or wiki, managing tasks, sending messages, creating approvals, exporting to Markdown, or any 飞书/Lark interaction.

2026-03-146

agent-swe-team

northseadl/norix-skills

Multi-agent SWE team built on the Workshop model. Full-stack vertical workers, meeting room with @mention notification, private pipes, shared task board. Git worktree isolation, Leader-driven coordination. Mixed Codex/Claude Code engine. Use when a task needs engineering depth beyond a single agent. NOT for simple task parallelism (use agent-task-orchestration) or design discussions (use agent-brainstorm).

2026-03-146

name	doc-sentinel
description	Document-code change notification system: traceable doc-code binding via git tree hash, git-diff-driven reconciliation plans with confidence/risk metadata, and idempotent execution. Use when maintaining documentation freshness, detecting stale docs, or binding docs to source code.
metadata	{"version":"0.2.0"}

Doc Sentinel — 文档-代码变更通知系统

核心概念

你负责守护一个仓库的文档健康度。三平面架构：

平面	目标	核心能力
Identity	绑定真值	文档 frontmatter 绑定 source paths + git tree hash
Reconciliation	变更推理	Git diff → ChangeEvent → Policy → ChangePlan (含 confidence/risk)
Capability	可选能力	索引生成（默认可用），矢量检索（未来独立技能）

核心价值：让 Agent 准确知道「哪些文档可能需要更新」，不承诺自动修复，不假装语义理解。

成功标准：

零漏报：代码变更必须被检测到
低误报：误报率 < 20%
可解释：每个通知附带变更证据和 confidence

工具

# 主入口
uv run <SKILLS_DIR>/doc-sentinel/scripts/sentinel.py <command> [options]

# --- 4 个核心命令 ---

# 1. 只读状态查询（无副作用）
status [--root <path>] [--doc <id>] [--source <path>] [--format json]

# 2. 建立/更新文档-代码绑定
bind <doc.md> [--source <path>...] [--auto-detect] [--root <path>]

# 3. 生成变更计划（不执行）
plan [--since <commit>] [--output plan.json] [--format json] [--root <path>]

# 4. 执行计划（幂等）
apply [--dry-run] [--root <path>]

工作流

Phase 1: 理解仓库

运行 status 查看文档健康状态
如无文档追踪，用 bind 为关键文档建立绑定

Phase 2: 绑定文档

为需要追踪的文档注入溯源 frontmatter：

# 显式指定源码路径
sentinel.py bind docs/auth.md --source "src/auth/" "src/middleware/auth.py"

# 自动检测（使用文档所在目录）
sentinel.py bind docs/api/overview.md --auto-detect

Phase 3: 检测变更

代码变更后，生成变更计划：

sentinel.py plan
# 输出：
#   📋 Stable actions (auto-executable):
#     📝 UPDATE → auth/overview
#        Reason: Source modified (42 lines): src/auth/handler.py
#   🔍 Review items (need confirmation):
#     ✨ CREATE → ?
#        Reason: New file in untracked area: src/billing/stripe.py

Phase 4: 执行计划

# 预览
sentinel.py apply --dry-run

# 执行（仅执行 STABLE 级别的操作）
sentinel.py apply

溯源 Frontmatter 规范

每份受管文档头部嵌入：

---
doc_id: "module/feature"
source_paths: ["module/src/"]
source_tree_hash: "a3f2b8c4d5e6"
last_sync_commit: "e7d1c4a..."
sync_timestamp: "2026-03-05T14:00:00+08:00"
doc_version: 3
status: "synced"
---

变更计划 (ChangePlan) 结构

每个 PlanItem 附带 Agent 可消费的元数据：

{
  "action": "update",
  "risk": "stable",
  "doc_id": "auth/overview",
  "reason": "Source modified (42 lines): src/auth/handler.py",
  "confidence": 0.84,
  "details": {
    "modified_source": "src/auth/handler.py",
    "lines_changed": 42
  }
}

动作分类:

分类	动作	语义
STABLE	UPDATE, RENAME, ARCHIVE	可自动执行，风险低
REVIEW	CREATE	需 Agent/人工确认

显著性阈值

修改 (M) 状态使用阈值过滤噪声（默认 5 行）。可通过环境变量调整：

DOC_SENTINEL_THRESHOLD=10 sentinel.py plan

数据目录

<repo_root>/.doc-sentinel/
├── registry.json          # 文档注册表（绑定关系）
├── last_sync_commit       # 上次同步 commit SHA
└── change_log.json        # 操作历史（保留最近 50 条）

参考文档

文档	用途	何时读取
decision-tree.md	变更操作决策树详解	处理 plan/apply 时
traceback-spec.md	溯源标识详细规范	维护 frontmatter 时

输出约定

思考/规划/报告: 中文
代码/命令/文件名: English
Frontmatter: YAML (English keys)