simonpokorny/knowledgebase

在仓库的 .knowledgebase/ 目录下创建一个小的、模式简洁的条目。如果仓库没有 .knowledgebase/ 目录，则停止并告知用户先运行 /setup-knowledgebase 技能。

1. 选择类型：

   内容类型	类型	路径
   关于系统的声明，真实且值得不再重新发现	发现	.knowledgebase/entries/finding-<主题-kebab>.md
   行为规则，通常源于错误	经验教训	.knowledgebase/entries/learning-<主题-kebab>.md
   在备选方案中做出的选择，包含权衡	决策	.knowledgebase/entries/decision-NNNN-<主题-kebab>.md

2. 编写条目。前置元数据字段、状态、限制和正文约定详见 ENTRY-FORMAT.md；请在编写前阅读。该插件的 templates/ 目录中提供了示例。

3. 确保状态是诚实的。对于发现和经验教训：仅当您在本会话中亲自验证了该声明时，才将状态设为 verified，然后设置 verified-by: agent 并在正文中提供证据（源码链接或您执行的检查）。任何您无法验证的内容保持 unverified 状态；这些是要求人类在审查中验证的条目。新决策获得 status: decided 并分为两类：

   • 实现决策：您自己在构建过程中做出的基本选择。记录其原因和权衡，并标记为 decided-by: agent。
   • 规划决策：与用户共同做出的、无法从代码推断的选择。也将其记录为 decided-by: agent，然后将会话结束报告中的采用行交给用户，使该条目变为 decided-by: human。 切勿亲自设置 decided-by: human；只有人类可以操作。任一类型的决策后来都可能被更新的决策 superseded。

4. 如果经验教训禁止某个命令，请添加 guard: 正则表达式，以便规则自动强制执行。守卫规则的编写规则见 ENTRY-FORMAT.md；在提交前使用 grep -E 测试正则表达式。

5. 在与产生该条目的变更所在的分支上提交该条目，使其随同一次提交一起进行。不要为后续提交批量创建条目。