minimal-implementation
Skill4 starsChanged 21 days agoMITView on GitHub
以最小正确改动完成代码、Skill、规则、脚本、修复、重构和工作流修改,并提供可复核的验证证据。用于修改代码、Skill、规则文件、脚本、辅助函数或工具,或用户要求优化、改进、重构、稳定化和增强鲁棒性的场景,避免不必要的辅助代码、降级路径、抽象、依赖、整文件重写和无关重构。
3 other projects use a version of this.
Adopted by
Most recently taken up by
- zxyycom/skillstheir own version, first seen Nov 8, 2026
- ooooooooooooooooooop/personal-aiword for word, first seen Oct 22, 2026
- yezhwi/superpowers-engineering-harnesstheir own version, first seen Sep 29, 2026
Other versions3 projects use a version of this.
Word for word · 1
- ooooooooooooooooooop/personal-ai★ 4100% same
Edited · 0
None found.
Wrote their own version · 2
- yezhwi/superpowers-engineering-harness★ 3same name
- zxyycom/skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- dsh-config/AGENTS.mdAGENTS.md
- chatgpt-web-bridgeSkill
- clarify-before-changeSkill
- decision-gatesSkill
- dsh-config-syncSkill
- environment-bootstrapSkill
- evolution-proposalSkill
- execution-disciplineSkill
- find-sessionSkill
- natural-rewriteSkill
- personal-ai-operations-reviewSkill
- publish-and-reuseSkill
- research-labSkill
- simulate-elite-expertsSkill
- skill-quality-gateSkill
- skill-repository-maintainerSkill
- subagent-execution-governanceSkill
- systematic-optimizationSkill
- task-mode-routerSkill
- unified-taskflowSkill
- world-model-runtimeSkill
- your-skill-nameSkill
The file
Files
最小正确实现
核心规则
只做当前请求需要的最小正确修改。用户明确要求架构、长期扩展或全面重构时,才扩大设计范围;普通“优化”不自动等于全面重写。
决策阶梯
新增代码、规则、文件、辅助函数或抽象前,依次确认:
- 这件事是否真的需要存在?
- 项目中是否已有实现、模式、规则、脚本或工具?
- 能否复用现有结构?
- 标准库是否足够?
- 平台原生能力是否足够?
- 已安装依赖是否足够?
- 只有前面都不满足时,才添加最小实现。
在第一个满足请求的层级停止。
变更预算
编辑前写下最小影响面、验收检查和明确不改的相邻文件。若新增抽象不能消除真实重复、提高正确性或让验证确定化,就不要新增。
安全边界
- 不添加无必要的 fallback、依赖、抽象或无关重构。
- 不用吞异常、静默降级、旧产物或修改测试预期掩盖根因。
- 修复共享路径上的根因,不只修补可见症状。
- 保留现有命名、结构和风格,除非用户明确要求改变。
- 只读审计不修改文件;高风险写入必须确认精确目标和回滚方式。
输出契约
小任务简要报告改动和验证。中大型任务报告:
- 修改面和复用的现有实现;
- 验收证据;
- 有意未修改的范围;
- 残余风险或真正阻塞。
验证
不要把 exit code 或旧产物单独当作成功证据。优先使用新鲜的定向测试、validator、哈希、渲染结果或直接行为检查。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

