用途:审计 .chalk/ 目录,确认 chalk.json 与 PROFILE 文档完整正确,能支撑依赖项目上下文的技能运行。适合在运行 capture-pr-visuals、create-pr 等技能前、初始设置后、定期检测文档过期时,或在 CI 中强制检查 chalk 质量。
主要能力与流程:第一步检查 .chalk/chalk.json 是否存在且有效,验证必填字段 version(须为 "1.0")与 project.name(须存在且非空);检查推荐字段 project.description、project.language、project.framework、project.type、dev.command、dev.port、dev.url、test.command、build.command、routes(至少一条)、sourceLayout.root,并校验取值合理性,如 dev.port 为 1-65535、dev.url 以 http 开头、routes 的 path 与 name 非空、sourceLayout 路径在磁盘存在。第二步检查 PROFILE 文档是否存在,包括 .chalk/docs/product/PROFILE.md、engineering/PROFILE.md、engineering/coding-style.md、ai/PROFILE.md、design/PROFILE.md,逐项确认存在、内容超过 20 行、不含 <!-- STUB --> 标记、含 Last updated: 行。第三步检测 v1 旧结构,如 0_PRODUCT_PROFILE.md、0_ENGINEERING_PROFILE.md、1_architecture.md、3_techstack.md 等编号文件,发现则提示需要迁移并建议运行 /setup-chalk 迁移。第四步将 chalk.json 与文档交叉校验,例如 routes 是否在 engineering/PROFILE.md 提及、框架是否被记录、sourceLayout 目录是否真实存在。第五步输出摘要报告,含各检查项通过与否及 Score: 7/11 checks passed 形式的分值。第六步若传入 fix 参数,则运行 /setup-docs 补齐缺失文档、执行路由与源码布局检测回填 chalk.json、经用户确认后迁移 v1 文件。
限制:默认仅报告不修改,只有传入 fix 参数才改动文件;缺失可选字段只警告不失败;导致失败的必填项为 chalk.json 必须存在且 version、project.name 必须存在。官方链接、安装方式、价格与平台支持等资料暂未提供。