メニュー
Capture implementation notes after code implementation and review/fix. Records design decisions, deviations, tradeoffs, and open questions to docs/issue#XXXX.html. Triggers on: /note-it, 记录笔记, implementation notes.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/smallnest/pigo --skill note-itコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | note-it |
| description | Capture implementation notes after code implementation and review/fix. Records design decisions, deviations, tradeoffs, and open questions to docs/issue#XXXX.html. Triggers on: /note-it, 记录笔记, implementation notes. |
| user-invocable | true |
After completing implementation and review/fix for an Issue, capture a running implementation notes file that documents how the implementation diverges from or interprets the spec.
Use when:
/goal implementation and /review-it are both complete/ship-it (as a final checkpoint)/goal target, or user input)docs/issue#XXXX.htmlThe HTML file must cover these four categories. If a category has nothing to report, write "None" with a brief explanation.
Choices made where the spec was ambiguous or silent:
Places where you intentionally departed from the spec:
Alternatives you considered and why you picked what you did:
Anything you'd want confirmed or revised:
docs/issue#XXXX.html (where XXXX is the zero-padded Issue number, e.g., issue#0042.html)Use this exact HTML structure:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Implementation Notes — Issue #XXXX</title>
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
background: #FAF9F6;
color: #1a1a1a;
padding: 2.5rem 2rem;
line-height: 1.7;
}
.container { max-width: 800px; margin: 0 auto; }
h1 { font-size: 1.375rem; font-weight: 700; margin-bottom: 0.25rem; }
.meta { color: ; : ; : ; }
{
: ;
: ;
: ;
: ;
: ;
: solid ;
: flex; : center; : ;
}
{
: ; : ; : ; : inline-block;
}
{ : ; }
{ : ; }
{ : ; }
{ : ; }
{
: ;
: solid ;
: ;
: ;
: ;
: (,,,);
}
{ : ; : ; : ; }
{ : ; : ; : ; }
{
: inline-block;
: ;
: ;
: ;
: ;
: ;
}
{ : ; : ; : solid ; }
{ : ; : ; : solid ; }
{ : ; : ; : solid ; }
{ : ; : ; : solid ; }
{ : ; : italic; : ; }
{
: center; : ; : ;
: ;
}
Implementation Notes
Issue #{{ISSUE_NUMBER}} {{ISSUE_TITLE}} {{DATE}}
Design Decisions
Deviations
Tradeoffs
Open Questions
Generated by goal-workflow /note-it
<div class="item">
<h3><span class="label label-design">Decision</span> Used interface-based polymorphism instead of switch</h3>
<p><strong>Ambiguity:</strong> The spec said "handle different types" without specifying how.</p>
<p><strong>Choice:</strong> Defined a <code>Handler</code> interface with per-type implementations.</p>
<p><strong>Rationale:</strong> Adding new types requires no changes to existing code (Open/Closed Principle). A switch would grow unboundedly.</p>
</div>
/note-it #42), use itfeat/issue-42-* or fix/issue-42-*, extract 42/goal target was #42, use 42| Scenario | Handling |
|---|---|
| No Issue number found | Ask the user to specify |
docs/ directory does not exist | Auto-create it |
| Notes file already exists for this Issue | Ask: "Update existing notes or overwrite?" — default to update (append new items) |
| No deviations or open questions | Write "None — implementation followed the spec as written." |
| Spec/PRD file not found | Note in Open Questions: "No PRD found at tasks/prd-*.md — verify against original requirements." |
Before saving: