skill-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skills Retrospective

Skills 回顾

Review and improve skills based on conversation experience.

基于对话经验对技能进行回顾与改进。

When to Trigger

触发时机

This skill activates when user asks for:

"复盘 skills" / "review skills" / "总结 skills"
"Skills 有什么问题" / "What issues with skills"
"Improve skills" / "优化 skills"
"Skills 需要改进的地方"

当用户提出以下需求时，该技能将激活：

"复盘 Skills" / "review skills" / "总结 Skills"
"Skills 有什么问题" / "What issues with skills"
"Improve skills" / "优化 Skills"
"Skills 需要改进的地方"

Retrospective Workflow

回顾工作流

Step 1: Identify Skills Used

步骤1：识别已使用的技能

List all skills loaded in this conversation:

```
tasknotes-skill
```
- TaskNotes CLI integration
```
skill-creator
```
- Base skill creation guidance

列出本次对话中加载的所有技能：

```
tasknotes-skill
```
- TaskNotes CLI 集成工具
```
skill-creator
```
- 基础技能创建指导工具

Step 2: Analyze Issues

步骤2：分析问题

For each skill, identify:

Command failures - What commands failed and why
Missing content - What should have been documented but wasn't
Incorrect guidance - What advice was wrong or misleading
Edge cases - What scenarios weren't covered
User confusion - Where user got confused

针对每个技能，识别以下问题：

命令执行失败 - 哪些命令失败了，原因是什么
内容缺失 - 哪些内容应该被记录但未记录
指导错误 - 哪些建议是错误或具有误导性的
边缘场景 - 哪些场景未被覆盖
用户困惑点 - 用户在哪些地方产生了困惑

Step 3: Prioritize Improvements

步骤3：优先级划分改进任务

Priority	Issue Type	Action
Critical	Wrong/misleading info	Fix immediately
High	Missing critical info	Add to SKILL.md
Medium	Edge case not covered	Add to troubleshooting
Low	Clarity improvement	Refine wording

优先级	问题类型	行动方案
紧急	错误/误导性信息	立即修复
高	关键信息缺失	添加至 SKILL.md
中	边缘场景未覆盖	添加至故障排除部分
低	清晰度提升	优化措辞

Step 4: Document Findings

步骤4：记录发现结果

Create a summary in this format:

markdown

undefined

按照以下格式创建总结：

markdown

undefined

Skills Review - [Date]

Skills 回顾 - [日期]

[Skill Name]

[技能名称]

Issues Found:

[Issue description] - [Root cause]
...

Improvements Made:

[Change] - [Location]
...

Still Missing:

[What's still needed]

undefined

发现的问题：

[问题描述] - [根本原因]
...

已完成的改进：

[变更内容] - [变更位置]
...

仍需补充的内容：

[所需内容]

undefined

Common Issues to Watch For

需要关注的常见问题

Command Option Mismatches

命令选项不匹配

Check
```
tn --help
```
for actual options
```
create
```
doesn't support
```
--priority
```
,
```
--tags
```
, etc.
```
update --add-projects
```
may silently fail

查看
```
tn --help
```
获取实际可用选项
```
create
```
命令不支持
```
--priority
```
、
```
--tags
```
等参数
```
update --add-projects
```
可能会静默失败

Path Handling

路径处理

Chinese punctuation in paths (。) requires exact matching
```
.md
```
extension may or may not be required
Use
```
tn list --json
```
to get exact IDs

路径中的中文标点（如。）需要精确匹配
可能需要或不需要
```
.md
```
扩展名
使用
```
tn list --json
```
获取精确ID

Natural Language Parsing

自然语言解析

```
∑
```
symbol causes parsing issues → use
```
_
```
instead
Project names with
```
-
```
may be misinterpreted
Test with simple cases first

```
∑
```
符号会导致解析问题 → 改用
```
_
```
替代
包含
```
-
```
的项目名称可能会被误解析
先使用简单案例进行测试

Actionable Improvements

可执行的改进措施

Immediate Actions

立即行动

Update SKILL.md with workaround for
```
update --add-projects
```
Document project naming convention (underscore vs sum symbol)
Add exact ID extraction patterns

更新 SKILL.md，添加
```
update --add-projects
```
命令的临时解决方法
记录项目命名规范（下划线 vs 求和符号）
添加精确ID提取规则

Documentation Updates

文档更新

Add "Gotchas" section for known issues
Include command output examples
Document batch operation risks

添加“注意事项”板块，记录已知问题
包含命令输出示例
记录批量操作的风险

Output Format

输出格式

When presenting improvements:

markdown

undefined

展示改进内容时，请使用以下格式：

markdown

undefined

Skills Review

Skills 回顾

tasknotes-skill

Issue	Root Cause	Fix
`--add-projects` silent fail	API bug	Use `_` in project name during creation
`∑` parsing issue	Parser limitation	Use `拓扑灵犀_infra建设` instead

问题	根本原因	修复方案
`--add-projects` 静默失败	API 漏洞	创建项目时在名称中使用 `_`
`∑` 解析问题	解析器限制	改用 `拓扑灵犀_infra建设` 这类命名

skill-creator

Issue	Root Cause	Fix
Missing skill-review	New requirement	Created skill-review

问题	根本原因	修复方案
缺少技能回顾功能	新需求	创建 skill-review 技能

Files Modified

修改的文件

/Users/oldwinter/.claude/skills/tasknotes-skill/SKILL.md

/Users/oldwinter/.claude/skills/skill-review/SKILL.md

undefined

/Users/oldwinter/.claude/skills/tasknotes-skill/SKILL.md

/Users/oldwinter/.claude/skills/skill-review/SKILL.md

undefined

Integration with Previous Session

与历史会话集成

If this is a continuation of a previous session:

Read the previous skills review (if exists)
Verify improvements were actually implemented
Note any regression or new issues
Build on previous findings

如果是延续之前的会话：

读取之前的技能回顾记录（如果存在）
验证改进是否已实际实施
记录任何回归问题或新出现的问题
基于之前的发现继续优化