grace-ask

分类: 开发与编程 | 上传者: osovv | 下载: 0 | 版本: v1.0（最新）

使用完整的项目上下文回答有关 GRACE 项目的问题。当用户对代码库、架构、模块或实现有疑问时使用 - 加载所有 GRACE 工件，导航知识图，并通过引用提供有依据的答案。

更新日志: Source: GitHub https://github.com/osovv/grace-marketplace

目录结构

当前层级: tree/main/plugins/grace/skills/grace/grace-ask/

📁 agents/
- 📄 openai.yaml 125 B
📄 SKILL.md 2.6 KB

SKILL.md

---
name: grace-ask
description: "Answer a question about a GRACE project using full project context. Use when the user has a question about the codebase, architecture, modules, or implementation — loads all GRACE artifacts, navigates the knowledge graph, and provides a grounded answer with citations."
---

Answer a question about the current GRACE project.

## Process

### Step 1: Load Project Context
Read the following files (skip any that don't exist):
1. `AGENTS.md` — project principles and conventions
2. `docs/knowledge-graph.xml` — module map, dependencies, exports
3. `docs/requirements.xml` — use cases and requirements
4. `docs/technology.xml` — stack, runtime, libraries
5. `docs/development-plan.xml` — phases, modules, contracts
6. `docs/verification-plan.xml` — tests, traces, log markers, and execution gates
7. `docs/operational-packets.xml` — canonical packet, delta, and failure handoff shapes

### Step 2: Identify Relevant Modules
Based on the question, find the most relevant modules:
1. Use the knowledge graph to locate modules related to the question
2. Follow CrossLinks to find connected modules
3. Read MODULE_CONTRACTs of relevant modules for detailed context
4. Read matching verification entries when the question is about behavior, failure modes, or testing

If the optional `grace` CLI is available, you may use:
- `grace module find <query> --path <project-root>` to resolve module IDs from names, paths, dependencies, or verification refs
- `grace module show M-XXX --path <project-root> --with verification` to pull the shared/public module snapshot
- `grace file show <path> --path <project-root> --contracts --blocks` to pull file-local/private context for the implementation details

### Step 3: Dive Into Code If Needed
If the question is about specific behavior or implementation:
1. Use MODULE_MAP to locate relevant functions/blocks
2. Read the specific START_BLOCK/END_BLOCK sections
3. Read function CONTRACTs for intent vs implementation details
4. Read nearby tests or log-marker assertions when they are the strongest evidence for expected behavior

### Step 4: Answer
Provide a clear, concise answer grounded in the actual project artifacts. Always cite which files/modules/blocks your answer is based on.

### Important
- Never guess — if the information isn't in the project artifacts, say so
- If the question reveals a gap in documentation or contracts, mention it
- If the question reveals a gap in tests, traces, or verification docs, mention it
- If the answer requires changes to the project, suggest the appropriate `$grace-*` skill

登录后下载/点赞/收藏 ❤ 92 | ★ 0

grace-ask

目录结构

SKILL.md

举报内容

提示