跳到正文
cccskills
免费在 GitHub 公开

implementation-notes

Keep a running implementation-notes.md during a build, logging every deviation from the plan and every discovered edge case. Use whenever implementing against an agreed plan or spec, especially in long autonomous sessions.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md1.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Implementation notes

No amount of planning removes every unknown; some only appear once the code is open. When the territory disagrees with the plan, don't stop and don't silently improvise — take the conservative option, write it down, and keep going. The notes file is how the next attempt learns from this one.

Steps

  1. At the start of the build, create implementation-notes.md with three headings: Deviations, Discovered edge cases, Questions for review.
  2. Whenever reality forces a choice the plan didn't cover:
    • pick the conservative option (the one that's easiest to reverse),
    • log it under Deviations: what the plan said, what was done instead, why, and what it would take to revisit,
    • continue working. Do not block on the user for reversible decisions.
  3. Log edge cases as they're found, even ones handled cleanly — they are exactly the unknowns the next plan should account for.
  4. Anything irreversible or scope-changing goes under Questions for review AND stops the work at a safe checkpoint. Deviating conservatively is fine; deviating expensively needs a human.
  5. At the end, append a five-line summary: deviations count, the one most likely to be revisited, edge cases found, and what the next session should read first. Reference the file in the handoff or PR.

Guardrails

  • The notes file is temporary working memory, not documentation. Keep entries to 2-3 lines each.
  • Never let the notes drift from reality — an unlogged deviation is worse than no notes at all, because the file claims completeness.
  • "Conservative" means reversible, not necessarily simple.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and examples. Use when building an MCP server or tool definition, writing an agent-facing script, or when an agent keeps misusing a tool it already has.

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Use when a plan depends on uncertain runtime, integration, or data behavior that inspection alone cannot establish. Not for preference interviews or routine implementation.

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

Surface the user's unknown unknowns before work starts. Use when the user is entering an unfamiliar codebase area, an unfamiliar domain (design, video, infra), or explicitly asks for a "blindspot pass" or to find their "unknown unknowns."

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

Generate several genuinely different throwaway variations (designs, approaches, drafts) for the user to react to. Use when the user can only recognize what they want by seeing it — visual design, UX flows, naming, tone — or asks to brainstorm or prototype before building.

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

After a working session, produce a report on what changed plus a quiz the user must pass before merging. Use when the user asks "what did we actually do," wants to review a large change, or invokes a quiz before merge.

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

Audit the instructions an agent already carries — CLAUDE.md, AGENTS.md, skills, tool descriptions — for contradictions, over-constraint, and duplication, then propose a cut list. Use when an agent ignores its own instructions, when a CLAUDE.md has grown bloated, or when the user asks to audit or rightsize their agent context.

中文简介正在准备中。当前显示原文说明。

Neeeophytee/finding-unknowns-skills3522026年9月28日 更新

查看 Neeeophytee 的全部技能

报告此技能的问题