CraftKit/README.md

CraftKit

CraftKit 是一组面向 Codex 插件市场的中性 Skill 工具。项目从通用问题出发独立实现能力，不携带任何公司的品牌、内部框架、业务规则、源码、模板或环境信息。

文档导航

• 协作约定：项目范围、Skill 设计、迁移边界、验证和 Git 规则。
• 迁移计划：迁移批次、依赖顺序、合并原则和验收门禁。
• 迁移追踪说明：来源指纹和状态维护方式。

插件组成

插件	用途	当前状态
dev	软件设计、编码、审查与测试	已初始化，暂无 Skill
doc	文档转换、整理与写作	已迁移 format-md、docx-to-md、md-to-docx、xlsx-to-md、archive
git	分支、提交、变更提取与集成	已迁移 commit-msg、branch、identity、export、integrate
knowledge	项目初始化、交接、复盘与经验	已迁移 handoff、init、trace、distill、lessons、worklog
skill	项目规范及 Skill 创建、迁移与维护	已迁移 guidance

目录结构

CraftKit/
├─ .agents/plugins/marketplace.json  # 仓库级 Codex 市场清单
├─ AGENTS.md                         # Codex 与贡献者协作约定
├─ migration/                        # 迁移计划、来源指纹与状态追踪
├─ plugins/                          # 可独立安装的插件
│  ├─ dev/
│  ├─ doc/
│  ├─ git/
│  ├─ knowledge/
│  └─ skill/
└─ README.md

开发约束

• Skill 必须独立重写，不复制公司插件的正文、脚本、模板、示例或规则库。
• 专有能力应先抽象为可配置、基于公开标准或用户显式输入的中性平替；不能仅因专有内容较多就整体排除。
• 发布内容不得出现公司名称、产品名称、内部域名、内部包名、项目名或人员信息。
• 每个 Skill 文件夹名必须与 SKILL.md frontmatter 的 name 一致。
• 新增或修改插件后必须执行 Skill 校验、插件校验和去公司化扫描。
• 上游变化只用于触发人工复核，不得自动覆盖已迁移内容。

本地使用

这是仓库级 marketplace。安装前先将本仓库注册为本地 marketplace，再按需安装其中的插件。正式发布前还需要补充许可证、公开仓库地址、作者信息、隐私政策及市场素材。