
Common Ground: {project_name}【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skillsLast updated: {timestamp} Project ID: {project_id}ESTABLISHEDTypeScript ConfigurationTypeScript strict mode with no implicit any [inferred]Source: tsconfig.jsonConfidence: 0.95Added: 2026-01-15Testing FrameworkJest for unit testing, Playwright for E2E [stated]Source: User confirmationConfidence: 1.0Added: 2026-01-15WORKINGComponent PatternsPrefer functional components with hooks over class components [inferred]Source: Codebase analysis (95% functional)Confidence: 0.75Added: 2026-01-15OPENDeployment TargetServer-side rendering vs static export [uncertain]Source: No clear indication in configConfidence: 0.3Added: 2026-01-15Note: Clarify before implementing routingHistoryDateChangeAssumptionFromTo2026-01-15promotedComponent PatternsOPENWORKING2026-01-15addedTypeScript Configuration—ESTABLISHED注意 [file-management.md](https://link.gitcode.com/i/e2f0e33de47fbf42b5dd1868405c7d20) 中定义的模板还包含**假设 ID**格式 A{number}如 A001、A002项目内顺序递增、永不复用与更完整的字段Type / Assumption / Source / Validated / Context。 ### 机器可读索引ground.index.json json { version: 1.0, project_id: github.com/user/repo, project_name: {human_readable_name}, created: {ISO_timestamp}, last_updated: {ISO_timestamp}, next_id: 4, assumptions: [ { id: A001, title: TypeScript Configuration, type: inferred, tier: ESTABLISHED, assumption: TypeScript strict mode with no implicit any, source: tsconfig.json, 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: [] }同步规则关键ground.index.json是事实源source of truthCOMMON-GROUND.md由 index.json重新生成任何变更都要同时更新两个文件永远不要手动编辑 COMMON-GROUND.md应重新生成。这意味着两条产物在语义上等价、保持同步同时index.md全局注册表记录了所有被跟踪项目的假设数与最近校验时间。八、推理图--graph让推理结构可见--graphflag 生成一张 mermaid 图展示的不只是 Claude 假设了什么还有它是如何得出这些假设的——即驱动当前方案的决策树。目的决策点Claude 在哪些地方做了选择已走路径 vs 未走路径推理链中不确定性所在的位置。示例图节点颜色约定颜色含义黄色#ffcc00决策点推理分叉绿色#90EE90已选路径高置信度灰色#cccccc备选方案考虑过但未采用橙色#FFB366不确定需要澄清蓝色#87CEEB实现细节具体行动节点命名约定与图生成流程reasoning-graph.md 给出了完整的 mermaid 生成规范前缀含义示例ROOT根任务ROOT[Task: Build auth]D{n}决策点D1{MVP or Production?}P{n}已选路径P1[Production-grade]A{n}备选方案A1[MVP approach]U{n}不确定节点U1[Redis sessions?]I{n}实现细节I1[15min token expiry]边edge标签应包含权重与来源标签权重范围建议[stated]0.8–1.0、[inferred]0.6–0.8、[assumed]0.5–0.7、[uncertain]0.2–0.5、[alternative]0.1–0.3。生成流程共 6 步识别根任务 → 映射主要决策 → 构建决策树 → 添加叶子实现 → 标记不确定性 → 应用样式。对话式更新把图当作可编辑工件由于图是纯文本的 mermaid你可以通过对话操纵它你说Claude 做什么Expand the MVP branch详细展开该子树Why not Redis sessions?解释推理可能调整权重I actually want Redis sessions更新图将该分支标记为已选Whats downstream of token rotation?展开该子树在 reasoning-graph.md 中切换路径的具体动作为交换样式原不确定节点变绿、原已选节点变橙、更新边权重、必要时展开子树、重新生成图。图的校验规则必须有恰好一个 ROOT 节点至少一个决策点D 节点所有节点都有样式带权重或标签的边必须没有孤立节点断连、环这是树而非图、缺失的样式定义、无标签的决策边。触发重新生成触发动作假设被提升节点变绿假设被降级节点变橙新增假设添加分支或叶子节点探索备选方案展开灰色分支用户请求展开添加子树细节永远保留完整的树结构——不要删除备选分支只需将它们置灰。九、--list 与 --check 模式详解--list只读视图从~/.claude/common-ground/{project_id}/COMMON-GROUND.md加载落地文件按层级分组展示全部假设## Common Ground: All Assumptions **Project:** {project_name} **Last Updated:** {timestamp} ### ESTABLISHED ({count}) 1. {title} - {assumption} [{type}] 2. ... ### WORKING ({count}) 1. {title} - {assumption} [{type}] 2. ... ### OPEN ({count}) 1. {title} - {assumption} [{type}] 2. ... --- (Read-only view. Run /common-ground to modify.)缺失文件处理若不存在落地文件提示No ground file found for this project. Run /common-ground to surface and track assumptions.--check快速校验加载落地文件通过AskUserQuestion呈现摘要问题如 Quick check: Are these assumptions still valid?选项All still valid全部仍然有效Some need updates部分需要更新Need full review需要完整评审处理响应全部有效更新last_validated时间戳并确认部分需更新询问哪些然后进入默认流程的 Phase 2需要完整评审运行完整默认流程缺失文件处理重定向到默认流程No existing assumptions to check. Starting fresh...然后执行默认模式。十、实战应用场景场景一开始新功能开发实现前显式化假设/common-groundClaude 会识别它对以下方面的假设架构模式、错误处理约定、测试要求、代码风格偏好。场景二接手陌生代码库/common-ground --graph查看 Claude 对项目结构的心理模型并在早期做出纠正。场景三大型重构之前验证假设没有漂移/common-ground --check在进行大规模改动前快速确认既有假设仍然成立。场景四调试错位输出当 Claude 产出意外结果时/common-ground --list【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考