Decision Recorder

decision-recorder 是一个 Node.js 命令行工具，用于结构化记录决策的问题、备选方案、理由、结果、背景与标签，并支持按关键词、标签、日期检索，查看、更新、删除记录以及分析决策模式，数据以 JSON 文件保存在本地目录。

harrylabsj

热度 52.37

最近更新 2026-06-06 05:11:06

分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 任务管理 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add decision-recorder

Metadata

name: decision-recorder
description: Record, review, search, and analyze decisions from technical work, product work, team discussions, and personal planning. Use when the user wants to capture why a decision was made, compare options, store rationale, track outcomes, or revisit past decisions by keyword, date, or tag.

Decision Recorder

Record decisions in a structured format so they can be searched, reviewed, and improved over time.

Core capabilities

Detect decision-oriented text
Create structured decision records
Search and filter past decisions
Review decision details
Analyze decision patterns
Update or delete stored decisions

Commands

Record a decision

decision-recorder record
decision-recorder r

List decisions

decision-recorder list
decision-recorder ls

Search decisions

decision-recorder search <keyword>
decision-recorder s <keyword>

Analyze patterns

decision-recorder analyze
decision-recorder a

View a specific decision

decision-recorder view <id>
decision-recorder v <id>

Update or delete a decision

decision-recorder update <id>
decision-recorder u <id>

decision-recorder delete <id>
decision-recorder d <id>

Detect decision keywords

decision-recorder detect "We decided to use Node.js"
decision-recorder keywords

Common filters

# Filter by tag
decision-recorder list --tag=important

# Filter by date range
decision-recorder list --from=2024-01-01 --to=2024-12-31

Programmatic usage

const dr = require('decision-recorder');

const record = dr.createDecision({
  question: 'Which backend stack should we use?',
  options: ['Node.js', 'Python', 'Go'],
  reasoning: 'Node.js has the best fit for fast iteration and ecosystem support.',
  result: 'Node.js',
  context: 'New product launch',
  tags: ['architecture', 'backend']
});

const matches = dr.searchDecisions('architecture');
const analysis = dr.analyzeDecisions();

Decision record format

{
  "id": "unique-id",
  "timestamp": "ISO-8601 timestamp",
  "question": "Decision question",
  "options": ["Option A", "Option B"],
  "reasoning": "Why this choice was made",
  "result": "Final choice",
  "context": "Background",
  "tags": ["tag-a", "tag-b"]
}

Data location

Decision records are stored under:

~/.decision-recorder/

Each decision is stored as a JSON file.

Recommended use cases

Architecture and technology choices
Product tradeoff decisions
Team decisions after discussion
Operational decisions and retrospectives
Personal planning and career decisions

Good practice

Record decisions soon after they are made.
Capture reasoning, not just outcomes.
Use tags consistently.
Review decisions periodically.
Compare similar decisions over time.

Notes

Requires Node.js 14 or later.
Uses local JSON files for storage.
Works best when reasoning and context are written clearly.

License

MIT