企业官网建设流程全解析

Common Ground: Project Registry

【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills

Last Updated: {timestamp}

Tracked Projects

Auto-generated by /common-ground command

### 更新规则 - **新建**：某项目首次创建 ground file 时，将其加入注册表； - **刷新**：每次运行 `/common-ground`（含 `--list`/`--check`/`--graph` 等模式）更新 `Assumptions` 计数与 `Last Check` 日期； - **移除**：当 ground file 被删除时移除对应项目（文档标注为 future 的 `--reset` 能力，当前需手动处理）。 `index.md` 相当于存储层的"总目录"，让 Agent 能在不逐个扫描项目子目录的情况下快速回答"我跟踪了哪些项目的共识"。 ## 五、人类可读文件（COMMON-GROUND.md）模板详解 每个项目一份，位于 `~/.claude/common-ground/{project_id}/COMMON-GROUND.md`。完整模板包含五个组成部分：文件头、三个置信层级区块（ESTABLISHED / WORKING / OPEN）、以及 History 审计表。 ### 5.1 模板全文 ```markdown # Project Common Ground **Project:** {project_name} **Project ID:** {project_id} **Created:** {created_timestamp} **Last Updated:** {updated_timestamp} --- ## ESTABLISHED High confidence assumptions. Treat as premises. ### {id}: {title} - **Type:** {stated|inferred|assumed} - **Assumption:** {description} - **Source:** {evidence or citation} - **Validated:** {date} - **Context:** {when this applies} --- ## WORKING Medium confidence. Use but flag if contradicted. ### {id}: {title} - **Type:** {stated|inferred|assumed} - **Assumption:** {description} - **Source:** {evidence or citation} - **Validated:** {date} - **Context:** {when this applies} --- ## OPEN Low confidence. Ask before assuming. ### {id}: {title} - **Type:** {stated|inferred|assumed|uncertain} - **Assumption:** {description} - **Source:** {evidence or citation} - **Validated:** {date} - **Context:** {when this applies} --- ## History | Date | Action | ID | Details | |------|--------|------|---------| | {date} | {Created/Promoted/Demoted/Archived} | {id} | {details} | --- *Managed by /common-ground command*

5.2 三个层级的语义差异

模板中每个字段都对 Agent 的后续行为有直接约束，各层级字段完全一致，差异在语义：

层级之间可通过 promote（OPEN→WORKING→ESTABLISHED）与 demote 双向迁移，迁移由用户在交互流程（Phase 2）中确认，且每次迁移都会在 History 表中留下审计记录。

5.3 假设 ID 格式：A{number}

• 项目内按A001、A002、A003顺序递增；
• 编号永不复用（即使假设被归档，其 ID 也不重新分配给新假设）；
• 当前最大 ID 记录在ground.index.json的next_id字段，作为下一次分配的起点。

这一设计保证了历史记录中的引用稳定性：任何对 "A003" 的引用在项目生命周期内都指向同一条假设，配合 History 表即可完整还原其生命周期。

六、机器可读文件（ground.index.json）Schema

位于~/.claude/common-ground/{project_id}/ground.index.json，是存储层的事实源（source of truth）。COMMON-GROUND.md本质上是它的"视图"，由命令在每次更新时重新生成。

6.1 完整 Schema

{ "version": "1.0", "project_id": "{project_id}", "project_name": "{human_readable_name}", "created": "{ISO_timestamp}", "last_updated": "{ISO_timestamp}", "next_id": 4, "assumptions": [ { "id": "A001", "title": "{short_title}", "type": "stated|inferred|assumed|uncertain", "tier": "ESTABLISHED|WORKING|OPEN", "assumption": "{full_description}", "source": "{evidence}", "validated": "{ISO_date}", "context": "{when_applies}", "created": "{ISO_timestamp}", "history": [ { "date": "{ISO_timestamp}", "action": "created|promoted|demoted", "from_tier": null, "to_tier": "WORKING", "reason": "{optional}" } ] } ], "archived": [] }

【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills