mcpField
D
decision-logger

decision-logger

github.com/alirezarezvani生产力28.9k614 次安装2 天前更新
代码仓库

关于 decision-logger

Decision Logger 是面向创始人及其团队的双层决策记忆 Skill,将会议原始记录与创始人批准的决策分开,并跟踪行动项、期限和冲突。

主要功能

  1. 01双层决策存储
  2. 02已批准决策历史
  3. 03行动项与期限跟踪
  4. 04冲突与矛盾检测
  5. 05按主题或负责人搜索

适用场景

  1. 01会前查看已批准决策
  2. 02查找逾期行动项
  3. 03核对提案是否与过往决策冲突
  4. 04按主题或负责人搜索决策

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill decision-logger

安装后在 Claude Code 中输入/decision-logger确认已加载。

附带文件scripts/decision_tracker.pytemplates/decision-entry.md

详细介绍

决策记录器

双层记忆系统。第 1 层存储所有内容。第 2 层仅存储创始人批准的内容。后续会议只读取第 2 层,以防过去讨论中虚构的共识影响新的审议。

关键词

决策日志、记忆、已批准的决策、行动项、董事会会议记录、/decision-logger decisions、/decision-logger review、冲突检测、DO_NOT_RESURFACE

快速入门

python scripts/decision_tracker.py --demo             # See sample output
python scripts/decision_tracker.py --summary          # Overview + overdue
python scripts/decision_tracker.py --overdue          # Past-deadline actions
python scripts/decision_tracker.py --conflicts        # Contradiction detection
python scripts/decision_tracker.py --owner "CTO"      # Filter by owner
python scripts/decision_tracker.py --search "pricing" # Search decisions

命令

命令效果
/decision-logger decisions最近 10 项已批准的决策
/decision-logger decisions --all完整历史记录
/decision-logger decisions --owner CMO按负责人筛选
/decision-logger decisions --topic pricing按关键词搜索
/decision-logger review查看 7 天内到期的行动项
/decision-logger review --overdue已逾期的事项

双层架构

存储采用规范的双层决策记忆布局(参见 ../agent-protocol/SKILL.md →“决策记忆(规范布局)”),与 /c-level-agents:decide 写入的布局相同。

第 1 层 — 原始转录

位置: ~/.claude/decisions/raw/YYYY-MM-DD-<slug>.md

  • 第 2 阶段 Agent 贡献、第 3 阶段批评和第 4 阶段综合的完整记录
  • 所有讨论,包括被否决的论点
  • **绝不会自动加载。**仅在创始人明确请求时加载。
  • 90 天后归档至 ~/.claude/decisions/raw/archive/YYYY/
第 2 层 — 已批准的决策

位置: ~/.claude/decisions/approved/ — 每项决策一条记录(YYYY-MM-DD-<slug>.md),以及只追加的索引 decisions.md

  • 仅包含创始人批准的决策、行动项和用户更正
  • 在每次董事会会议的第 1 阶段自动加载
  • 只追加。决策永不删除,只会被取代。
  • 由幕僚长在第 5 阶段后管理。Agent 不得直接写入。

迁移:旧版可能存在 memory/board-meetings/ 文件夹;可读取其中的历史记录,但所有新条目都必须写入 ~/.claude/decisions/。


决策条目格式

## [YYYY-MM-DD] — [AGENDA ITEM TITLE]

**Decision:** [One clear statement of what was decided.]
**Owner:** [One person or role — accountable for execution.]
**Deadline:** [YYYY-MM-DD]
**Review:** [YYYY-MM-DD]
**Rationale:** [Why this over alternatives. 1-2 sentences.]

**User Override:** [If founder changed agent recommendation — what and why. Blank if not applicable.]

**Rejected:**
- [Proposal] — [reason] [DO_NOT_RESURFACE]

**Action Items:**
- [ ] [Action] — Owner: [name] — Due: [YYYY-MM-DD] — Review: [YYYY-MM-DD]

**Supersedes:** [DATE of previous decision on same topic, if any]
**Superseded by:** [Filled in retroactively if overridden later]
**Raw transcript:** ~/.claude/decisions/raw/[DATE]-<slug>.md

冲突检测

记录前,幕僚长会检查以下情况:

  1. 违反 DO_NOT_RESURFACE — 新决策与已否决的提案相符
  2. 主题矛盾 — 同一主题存在两项结论不同的有效决策
  3. 负责人冲突 — 不同决策将同一行动分配给不同人员

发现冲突时:

⚠️ DECISION CONFLICT
New: [text]
Conflicts with: [DATE] — [existing text]

Options: (1) Supersede old  (2) Merge  (3) Defer to founder

DO_NOT_RESURFACE 执行规则:

🚫 BLOCKED: "[Proposal]" was rejected on [DATE]. Reason: [reason].
To reopen: founder must explicitly say "reopen [topic] from [DATE]".

记录工作流(第 5 阶段之后)

  1. 创始人批准综合结果
  2. 将第 1 层原始转录写入 ~/.claude/decisions/raw/YYYY-MM-DD-<slug>.md
  3. 对照 ~/.claude/decisions/approved/decisions.md 检查冲突
  4. 提出冲突,等待创始人解决
  5. 将已批准的记录写入 ~/.claude/decisions/approved/YYYY-MM-DD-<slug>.md,并追加到索引 decisions.md
  6. 确认:决策已记录、行动已跟踪、DO_NOT_RESURFACE 标记已添加

标记行动已完成

- [x] [Action] — Owner: [name] — Completed: [DATE] — Result: [one sentence]

切勿删除已完成的事项。历史记录就是凭据。


文件结构

~/.claude/decisions/
├── raw/YYYY-MM-DD-<slug>.md        # Layer 1: full transcript per meeting
├── raw/archive/YYYY/               # Raw files after 90 days
├── approved/YYYY-MM-DD-<slug>.md   # Layer 2: one record per approved decision
└── approved/decisions.md           # Layer 2 index: append-only, founder-approved

参考

  • templates/decision-entry.md — 单条记录模板及字段规则
  • scripts/decision_tracker.py — CLI 解析器、逾期跟踪器和冲突检测器

评论

支持 Markdown