重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
adr-code-traceability by terrylica/cc-skills
npx skills add https://github.com/terrylica/cc-skills --skill adr-code-traceability为代码添加架构决策记录引用,以实现决策可追溯性。提供特定语言模式和放置指南。
/itp:go 第一阶段向代码中添加决策上下文时ADR: {adr-id}
路径推导 : ADR: 2025-12-01-my-feature → /docs/adr/2025-12-01-my-feature.md
| 语言 | 新文件头部 | 行内注释 |
|---|---|---|
| Python | """...\n\nADR: {adr-id}\n""" |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
# ADR: {adr-id} - reason |
| TypeScript | /** ... \n * @see ADR: {adr-id} */ | // ADR: {adr-id} - reason |
| Rust | //! ...\n//! ADR: {adr-id} | // ADR: {adr-id} - reason |
| Go | // Package ... \n// ADR: {adr-id} | // ADR: {adr-id} - reason |
查看 语言模式 获取完整示例。
Is this a NEW file created by the ADR?
├── Yes → Add reference in file header
└── No → Is the change non-obvious?
├── Yes → Add inline comment with reason
└── No → Skip ADR reference
查看 放置指南 获取详细指导。
"""
Redis cache adapter for session management.
ADR: 2025-12-01-redis-session-cache
"""
class RedisSessionCache:
...
// ADR: 2025-12-01-rate-limiting - Using token bucket over sliding window
// for better burst handling in our use case
const rateLimiter = new TokenBucketLimiter({ rate: 100, burst: 20 });
| 问题 | 原因 | 解决方案 |
|---|---|---|
| ADR 未找到 | 路径格式错误 | 使用相对于仓库根目录的路径 |
| 引用未显示 | 注释语法错误 | 检查特定语言的注释格式 |
| 引用过多 | 过度文档化 | 仅在可追溯性有价值的地方添加 |
| ADR 链接过时 | ADR 已重命名 | 更新路径以匹配当前 ADR 文件名 |
| 钩子提醒烦人 | 此更改没有 ADR | 添加行内 ADR 注释或创建新的 ADR |
每周安装数
65
代码仓库
GitHub 星标数
24
首次出现
2026年1月24日
安全审计
安装于
opencode62
gemini-cli61
codex60
cursor59
github-copilot59
amp58
Add Architecture Decision Record references to code for decision traceability. Provides language-specific patterns and placement guidelines.
/itp:go Phase 1ADR: {adr-id}
Path Derivation : ADR: 2025-12-01-my-feature → /docs/adr/2025-12-01-my-feature.md
| Language | New File Header | Inline Comment |
|---|---|---|
| Python | """...\n\nADR: {adr-id}\n""" | # ADR: {adr-id} - reason |
| TypeScript | /** ... \n * @see ADR: {adr-id} */ | // ADR: {adr-id} - reason |
| Rust | //! ...\n//! ADR: {adr-id} | // ADR: {adr-id} - reason |
| Go | // Package ... \n// ADR: {adr-id} | // ADR: {adr-id} - reason |
See Language Patterns for complete examples.
Is this a NEW file created by the ADR?
├── Yes → Add reference in file header
└── No → Is the change non-obvious?
├── Yes → Add inline comment with reason
└── No → Skip ADR reference
See Placement Guidelines for detailed guidance.
"""
Redis cache adapter for session management.
ADR: 2025-12-01-redis-session-cache
"""
class RedisSessionCache:
...
// ADR: 2025-12-01-rate-limiting - Using token bucket over sliding window
// for better burst handling in our use case
const rateLimiter = new TokenBucketLimiter({ rate: 100, burst: 20 });
| Issue | Cause | Solution |
|---|---|---|
| ADR not found | Wrong path format | Use relative path from repo root |
| Reference not showing | Comment syntax wrong | Check language-specific comment format |
| Too many references | Over-documenting | Only add where traceability adds value |
| Outdated ADR link | ADR was renamed | Update path to match current ADR filename |
| Hook reminder annoying | No ADR for this change | Add inline ADR comment or create new ADR |
Weekly Installs
65
Repository
GitHub Stars
24
First Seen
Jan 24, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode62
gemini-cli61
codex60
cursor59
github-copilot59
amp58
冲刺回顾模板:敏捷团队回顾会议指南与模板(开始-停止-继续/愤怒-悲伤-高兴/4Ls)
10,400 周安装