用途:本技能是 How / What / Why / Why not 四原则的入口索引,本身不承载详细规约,而是按工作对象把使用者导向对应 SoT 技能,用于在创建、修改或审查本仓库中的生产代码、测试代码、提交消息或日志、代码注释之前统一规范。
四原则与归属: 代码对应 How——代码本身应表明实现方法,本技能只给指针,不设 SoT。 测试代码对应 What——应展示从调用侧可观测的结果、行为、规格与契约,不依赖内部实现,归 tdd/SKILL.md、tdd/tests.md。 提交日志对应 Why——说明为何如此实现或变更,归 kf-g-git-commit-japanese-commit-message。 代码注释对应 Why not——说明为何未采用其他方案、为何不能简化或删除,归 kf-g-code-comment-rules。
使用方式(按作业类型的必要步骤): 阅读时先定位与作业对象(代码 / 测试 / commit / 注释)对应的原则行,再 Read 相应 SoT 技能;How 无 SoT,以实现本身说明方法。 写或改代码前:在本技能确认 How 职责,由实现本身表达方法,不把 How 推给注释或 commit。 写或改测试前:确认 What 职责,Read tdd/SKILL.md,必要时 Read tdd/tests.md。 写 commit 消息前:确认 Why 职责,Read kf-g-git-commit-japanese-commit-message;请求提交时并用以 kf-g-git-commit-staged-only-rules 为准(canonical);仅当用户明确指定 /genshijin-commit 时才使用 genshijin-commit。 写或改代码注释前:确认 Why not 职责,Read kf-g-code-comment-rules。
最终检查:各产物应符合对应原则;详细规约不得复制到本技能中;确认已 Read 相应 SoT 技能。
限制:资料未提供安装命令、平台支持范围、价格与收费信息,暂未提供;具体规约以各 SoT 技能文件为准。