AGENT SKILL
note
把定型的决策/参考资料轻量记进持久台账 docs/plan/NOTES.md,供 /contract 收割。记 why 不复制内容、遮敏感信息、追加不覆盖。含 ref 职能。Trigger:/note、记下来、这个决定记一下、留个引用。
- License 许可
- MIT
- 最近更新
- 2026-10-11
- Stars
- ★ 44
- Forks
- 2
01 前言 Front Matter
- name
- note
- description
- 把定型的决策/参考资料轻量记进持久台账 docs/plan/NOTES.md,供 /contract 收割。记 why 不复制内容、遮敏感信息、追加不覆盖。含 ref 职能。Trigger:/note、记下来、这个决定记一下、留个引用。
03 SKILL.md 正文
/note — 决策台账
对应 pi TUI 的 /note(并入 /ref 职能)。审议中定型的决策要当场持久化——上下文会被压缩,没记下的决策等于没做过。追加到目标 repo 的 docs/plan/NOTES.md(没有就建)。
- [2026-07-21] 决策: 用 SQLite 不用 Postgres — 单机部署, 运维成本优先
- [2026-07-21] 参考: docs/plan/2026-07-19-omd-mcp-server.md §D-9 — server 退出双保险的由来
三条原则(直接降 token)
- 引用不复制 — 记决策就记 why,引已有产物(commit sha / plan path / 前沿票 slug / 报告路径)只写它的 path,绝不把内容内联复制进台账。代码里 git diff 已有 what,台账只补 why。
- 遮敏感信息 — 台账里遮掉 secret / API key / token / PII,命中写
<redacted:kind>。台账进 git,泄漏一次撤不回。 - 追加不覆盖 — 新条目追到台账,旧条目原样留(时间线可回溯)。台账太长时最旧的批量移到
docs/plan/_JOURNAL.md,不在 NOTES.md 里删历史。
升级路径
- NOTES.md 是轻量暂存;审议收敛时
/contract把这些条目收割进正式 SDD 的 Decisions 段。
与既有 skill 的边界
/note= 轻量记台账(一句话决策 + 引用)。不用于:- 结晶成正式 SDD 契约文档 →
/contract。
- 结晶成正式 SDD 契约文档 →
04 同仓库更多 Skills
skill-with-check
暂无简介
★ 44
skill-prose-bans
暂无简介
★ 44
skill-escalation-skill
暂无简介
★ 44
bugfix-triage
修 bug 前的定位方法论 —— 最小复现、二分缩圈、区分"测试错了"与"实现错了"
★ 44
ui-reviewer
Review rendered UI screenshots for hierarchy, spacing, readability, states, consistency, and visual slop.
★ 44
sast
确定性 semgrep 静态扫描(SAST)+ 结构化报告。零 LLM 零成本,规则命中即事实。Trigger:/sast、静态扫描、semgrep、扫一下代码。
★ 44