AgentSkillsCN

grace-add

在GRACE项目中，通过合同与知识图谱录入，新增一个模块。当需要引入原本不在原计划之内的新模块时使用——设计合同、更新规划文档、生成代码，并验证集成效果。

SKILL.md
--- frontmatter
name: grace-add
description: "Add a new module to a GRACE project with contract and knowledge graph entry. Use when you need to introduce a new module that wasn't part of the original plan — designs the contract, updates planning artifacts, generates code, and verifies integration."

Add a new module to the project.

Process

Step 1: Understand Context

Read docs/knowledge-graph.xml to understand:

  • •What modules already exist
  • •What the new module will connect to
  • •What gap it fills

Step 2: Design Contract

Propose a MODULE_CONTRACT for the new module:

  • •PURPOSE
  • •SCOPE
  • •DEPENDS (which existing modules)
  • •Key functions/components it will expose

Present to user and wait for approval.

Step 3: Update Planning Artifacts

After approval:

  1. •Add the module to docs/development-plan.xml using unique ID-based tag: M-xxx NAME="..." TYPE="..." LAYER="N" ORDER="N". Use export-name for interface entries, step-N for pipeline steps. See AGENTS.md "Documentation Artifacts" for full convention.
  2. •Add the module to docs/knowledge-graph.xml with unique ID-based tag: M-xxx NAME="..." TYPE="...". Use fn-name, type-Name, class-Name for annotation entries. Add CrossLinks to dependencies.

Step 4: Generate Code

Follow the same generation protocol as $grace-generate:

  • •Full MODULE_CONTRACT header
  • •MODULE_MAP
  • •CHANGE_SUMMARY
  • •Contracts for each function/component
  • •Semantic blocks with unique names

Step 5: Verify Integration

  • •Check that imports from existing modules resolve
  • •Run type checking or linting as appropriate for the project language
  • •Verify CrossLinks are bidirectionally consistent in the knowledge graph