mcpField
G
grace-init

grace-init

github.com/osovv开发25640 次安装5 周前更新
代码仓库

关于 grace-init

grace-init 使用模板为项目创建标准的 GRACE 4 上下文、图谱、验证文件及变更目录，适用于开始采用 GRACE 的项目。未经确认不会覆盖现有文件。

主要功能

  1. 01创建标准 GRACE 4 文件
  2. 02根据模板填充 XML 文件
  3. 03创建上下文、图谱和验证结构
  4. 04未经确认不覆盖现有内容
  5. 05可用时使用 grace lint 验证

适用场景

  1. 01在项目中初始化 GRACE 结构
  2. 02添加上下文与验证模板
  3. 03设置活动及归档变更目录

MCP 相关

此技能初始化供 GRACE 使用的项目文件，包括图谱、验证和变更目录。CLI 可用时，它建议使用 GRACE CLI 验证设置。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/osovv/grace-marketplace --skill grace-init

安装后在 Claude Code 中输入/grace-init确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
AGENTS.md.template
assets/.grace/context/
deployment.xml.template
principles.xml.template
requirements.xml.template
technology.xml.template
ux-guidelines.xml.template
assets/.grace/graph/
index.xml.template
main.xml.template
assets/.grace/verification/
index.xml.template
main.xml.template

详细介绍

根据此技能的 `assets/` 模板，创建规范的 GRACE 4 项目布局：
  • AGENTS.md
  • .grace/context/requirements.xml
  • .grace/context/technology.xml
  • .grace/context/principles.xml
  • .grace/context/deployment.xml
  • .grace/context/ux-guidelines.xml
  • .grace/graph/index.xml
  • .grace/graph/main.xml
  • .grace/verification/index.xml
  • .grace/verification/main.xml
  • .grace/changes/active/
  • .grace/changes/archive/

每个 XML 文件都使用 graceVersion="4.0"。语义锚点必须使用 XML 标签，不能使用属性。不要创建虚设的 C-* 变更包。未经明确确认，不得覆盖现有的 .grace 文件。

<template_sources>

模板源文件项目中的目标路径
assets/AGENTS.md.templateAGENTS.md
assets/.grace/context/requirements.xml.template.grace/context/requirements.xml
assets/.grace/context/technology.xml.template.grace/context/technology.xml
assets/.grace/context/principles.xml.template.grace/context/principles.xml
assets/.grace/context/deployment.xml.template.grace/context/deployment.xml
assets/.grace/context/ux-guidelines.xml.template.grace/context/ux-guidelines.xml
assets/.grace/graph/index.xml.template.grace/graph/index.xml
assets/.grace/graph/main.xml.template.grace/graph/main.xml
assets/.grace/verification/index.xml.template.grace/verification/index.xml
assets/.grace/verification/main.xml.template.grace/verification/main.xml
</template_sources>
1. 收集项目名称、说明、关键词、语言/运行时/框架、测试技术栈、可观测性限制、部署适用性、UX 适用性，以及已知的初始模块。 2. 如果 `.grace` 或 `AGENTS.md` 已存在，请停止并询问用户是否保留、合并或覆盖每个现有文件。绝不可在未告知的情况下覆盖。 3. 创建 `.grace/context`、`.grace/graph`、`.grace/verification`、`.grace/changes/active` 和 `.grace/changes/archive`。 4. 读取每个 `.template` 文件，将 `$PLACEHOLDER` 值替换为收集到的项目信息，然后写入目标文件。 5. 列出已创建的文件，并建议接下来的工作流：使用 `grace-spec` 创建一个活动的 `GraceChangeSpec`，然后使用 `grace-plan` 在实现前生成 `GraceChangePlan`。

<hard_rules>

  • GRACE 4 状态存放在 .grace 下；不要将旧版 docs/*.xml 作为初始化入口。
  • GraceChangeSpec 和 GraceChangePlan 由后续变更工作流创建，而不是由初始化流程创建。
  • 如果存在旧版 GRACE 3 文档，请说明只有 grace-migrate 负责迁移；初始化流程不得转换或删除这些文档。
  • CLI 可用时，使用 grace lint --path <project-root> 验证生成的项目。 </hard_rules>

评论

支持 Markdown